home *** CD-ROM | disk | FTP | other *** search
Text File | 1985-02-24 | 151.0 KB | 4,451 lines
QQQQQQQQQQQ SSSSSSSSSS YYY YYY SSSSSSSSSS QQQ QQQ SSS SSS YYY YYY SSS SSS QQQ QQQ SSS YYY YYY SSS QQQ QQQ SSS YYY YYY SSS QQQ QQQ SSSSSSSSSS YYYYYY SSSSSSSSSS QQQ Q QQQ SSS YYYYY SSS QQQ QQQQ SSS YYYY SSS QQQ QQQ SSS YYY SSS QQQ QQQQ SSS SSS YYY SSS SSS QQQQQQQQQQQ Q SSSSSSSSSS YYYYYY SSSSSSSSSSS Version 3.00 (C) Copyright 1984 Dennis Lee TABLE OF CONTENTS PREFACE QSYS Description..........................................PREF - 1 System Requirements.......................................PREF - 1 Voluntary Support.........................................PREF - 2 Limited License...........................................PREF - 2 List of QSYS Files........................................PREF - 3 GENERAL INFORMATION Security System...........................................GEN - 1 Screen Format.............................................GEN - 2 QSYS Editor...............................................GEN - 3 QSYS INSTALLATION Before Installation.......................................INST - 1 Backing up your system..................................INST - 1 Backing up QSYS.........................................INST - 2 Installation..............................................INST - 3 User Configuration Files................................INST - 3 QSYS Installation Aid...................................INST - 5 After Installation........................................INST - 11 Required Operating Files................................INST - 11 Default SYSTEM MENU.....................................INST - 11 MEMBRAIN Configuration..................................INST - 11 SYSTEM STARTUP Startup Sequence..........................................STRT - 1 CLOCK/CALENDAR Description and Functions.................................CLK - 1 MENU SYSTEM Description...............................................MENU - 1 Task Selection............................................MENU - 2 Menu Selection............................................MENU - 2 Available Functions.......................................MENU - 3 QSYS Command Line.........................................MENU - 4 Executing .COM, .EXE, or .BAT files.....................MENU - 4 Executing BASIC Programs................................MENU - 5 Menu Editor...............................................MENU - 6 Task or Menu Descriptors................................MENU - 6 General Information.....................................MENU - 7 Adding Descriptors......................................MENU - 8 Editing Existing Descriptors............................MENU - 8 Deleting Descriptors....................................MENU - 8 Selecting a Menu........................................MENU - 8 Creating a New Menu.....................................MENU - 9 Deleting a Menu.........................................MENU - 9 Relocating a Menu.......................................MENU - 9 JOBQ Description...............................................JOBQ - 1 Special JOBQ Commands.....................................JOBQ - 1 DOS Batch File Commands and Labels in the JOBQ............JOBQ - 1 Use of QLDR in User Batch Files...........................JOBQ - 1 JOBQ Functions............................................JOBQ - 2 Pre-Release JOBQ Functions..............................JOBQ - 2 JOBQ Execution Services.................................JOBQ - 3 JOBQ Execution Control..................................JOBQ - 3 MSGQ Description and Functions.................................MSGQ - 1 CONT - 1 TABLE OF CONTENTS MESSAGE SYSTEM Description...............................................MSG - 1 Loading Options...........................................MSG - 1 Common Editing Features...................................MSG - 1 Message Data Fields.......................................MSG - 2 Messages Menu.............................................MSG - 3 Help Facility.............................................MSG - 3 DISPLAY Message Function..................................MSG - 4 PREVIEW Message Function..................................MSG - 5 ENTER NEW Message Function................................MSG - 6 SEARCH/EDIT Message Function..............................MSG - 7 SET TIME & DATE Function..................................MSG - 8 FILE REORGANIZATION Procedure.............................MSG - 8 QSYS CONFIGURATION Description...............................................CNFG - 1 Loading Options...........................................CNFG - 1 Configuration Menu........................................CNFG - 1 User Control Menu.......................................CNFG - 2 Add New Users.........................................CNFG - 2 Delete Users..........................................CNFG - 2 Change User Name......................................CNFG - 2 Change Password.......................................CNFG - 2 Change Security Clearance.............................CNFG - 3 Function Keys.........................................CNFG - 3 Keyboard/Display Configuration..........................CNFG - 4 Display Parameters....................................CNFG - 4 Keyboard Parameters...................................CNFG - 5 Function Keys.........................................CNFG - 5 Clock Configuration.....................................CNFG - 6 Set Time..............................................CNFG - 6 Set Date..............................................CNFG - 6 Display Options.......................................CNFG - 6 Format Options........................................CNFG - 7 Sound Options.........................................CNFG - 7 Function Keys.........................................CNFG - 7 SYSTEM MESSAGES Description...............................................ERR - 1 Informational Messages....................................ERR - 2 Procedural Error Messages.................................ERR - 3 System Error Messages.....................................ERR - 8 APPENDIXES A - MEMBRAIN Documentation................................APP - A1 Description.............................................APP - A1 System Requirements.....................................APP - A1 Installation............................................APP - A1 Configuration Tips......................................APP - A2 Operational Characteristics.............................APP - A3 B - QLDR Documentation....................................APP - B1 Description.............................................APP - B1 Input Parameters........................................APP - B1 Output Return Code......................................APP - B3 C - QSYS Base Menu........................................APP - C1 GLOSSARY....................................................GLOS - 1 CONT - 2 PREFACE QSYS is a set of programs designed to help you integrate your existing program library into a menu driven system supporting multiple users who need not have a working knowledge of DOS. QSYS was originally designed for my own use. I needed a means of allowing every member of my family the use of a personal computer, while providing some protection against accidental file modifications or erasures. QSYS incorporates a security system that probably won't be effective against an experienced programmer, but will certainly provide some protection from the usually more dangerous inexperienced user. If you have children, you'll soon learn it's value. The other members of my family want to use the computer, but they don't especially care to read the documentation. They don't know which diskettes the programs are on, and even if they did, they don't have the knowledge of DOS necessary to load them. I'm afraid that if they had to learn DOS to use the computer, they wouldn't use the computer! QSYS makes it possible for them to select the program they want to run from a menu. If the program isn't on a diskette already mounted, QSYS will prompt for it by name. When they finish, they simply terminate the program and DOS will reload QSYS. If they forget to sign-off, QSYS will do it for them. QSYS also incorporates a concurrent message handling system. This was written mostly for my benefit. I have a terrible memory, and the message system allows me to keep appointments and pay my bills on time. It will notify me even if I have the computer tied up doing something else, as I often do. SYSTEM REQUIREMENTS - IBM PC or PC-XT QSYS will probably also work on some IBM compatibles, but no guarantee is made. - DOS 2.X QSYS will not work with the previous versions of DOS. - 192K of Memory - IBM Compatible Color/Graphics Monitor Adapter QSYS operates in 80 column mode. You don't need a color monitor, but will not work with the Monochrome Display Adapter. - Two Double-sided, Double-density Diskette Drives or - A Winchester Disk and One Double-sided Diskette Drive QSYS supports drives A-Q, but requires at least the minimum configuration. PREF - 1 PREFACE HOW TO GET QSYS QSYS is made available through Voluntary Support. This means that I will volunteer to send it to you FREE for evaluation. If you use it, you should volunteer to send me the suggested $50 contribution. What this all comes right down to, is that nobody knows the value of a particular program until they've had time to use it. Most software is just too complex to evaluate in a store. Voluntary support gives you the opportunity to evaluate programs on your own system, in conjunction with software that you already use, and for as long as it takes to make a good decision. If you use QSYS, then the $50 contribution is cheap!!! However, if you don't use it, or can't use it, then don't pay for it! 1) Volunteer to send me the $50 contribution and I'll voluntarily send you (2) diskettes of my very own full of QSYS. Also, I'll respond to requests for assistance in the installation and use of QSYS, and offer future releases for a minimal update fee. 2) Volunteer to send me $10 to cover the cost of the necessary diskettes, mailer, and postage, and I'll volunteer to send you QSYS to evaluate. If you use it, you can volunteer to send the additional $40 at your convenience. If you don't like QSYS, at least you got some diskettes. No support will be made available without the suggested contribution. 3) Volunteer to send me (2) diskettes with pre-addressed, postage- paid diskette mailer(s) of your very own, and I'll volunteer to return them to you full of QSYS to evaluate absolutely FREE! As with method #2, I won't volunteer my time to support QSYS for anyone who hasn't volunteered the suggested contribution. Keep in mind that I'll * GIVE * you a copy to evaluate, but I won't * PAY * to send it to you. If you select this method to obtain QSYS, please be sure to include TWO (2) diskettes, complete with mailer(s) and sufficient return postage. DENNIS LEE 5617 MURDOCH ST.LOUIS, MO. 63109 CompuServe # 70376,452 LIMITED LICENSE Feel free to distribute unaltered copies of the QSYS installation and documentation diskettes to friends, enemies, or people you don't even know, for the purpose of evaluation, as long as you do it FREE! Anyone incurring an expense in the distribution of QSYS, is granted permission to recover only the actual expense involved, and then only when notice is provided that a contribution to the author is requested. QSYS may not be sold by itself, or in conjunction with another product, without written permission of the author. GUARANTEE - NONE PREF - 2 PREFACE LIST OF QSYS FILES The QSYS system consists of the following files: * QSYS.EXE - main program module * QCNFG.EXE - configuration utility * QINT.EXE - concurrent message interrupt handler * QMSG.EXE - message program module * MEMBRAIN.EXE - configures and creates MEMBRAIN.SYS MEMBRAIN.SYS - emulated drive device driver JOBQ.BAT - dynamic JOBQ batch file QSYS.SYS - configuration information file SYSTEM.MNU - base menu file MSGS.DAT - message file AUTOEXEC.BAT - system startup procedure batch file CONFIG.SYS - DOS system configuration parameter file The QSYS INSTALLATION AID consists of the following files: * QINST.EXE - installation configuration program * AUTOEXEC.BAT - installation startup procedure batch file * CONFIG.SYS - default system configuration parameter file * MEMBRAIN.SYS - default emulated drive device driver The QSYS Documentation consists of the following files: * MAKEDOC.TXT - how to print the documentation * MAKEDOC.BAT - combines or prints the documentation files * Q_TITLE.DOC - title page * Q_CONT.DOC - table of contents * Q_PREF.DOC - preface * Q_GEN.DOC - general information * Q_INST.DOC - installation instructions * Q_START.DOC - startup procedure * Q_CLOCK.DOC - clock/calendar * Q_MENU.DOC - menu system * Q_JOBQ.DOC - JOBQ * Q_MSGQ.DOC - MSGQ * Q_MSG.DOC - message system * Q_CNFG.DOC - QSYS configuration * Q_ERR.DOC - system messages * Q_APPA.DOC - APPENDIX A * Q_APPB.DOC - APPENDIX B * Q_APPC.DOC - APPENDIX C * Q_GLOS.DOC - glossary Files marked with an asterisk (*) are included with the system, and are necessary for installation. All other files will be created as required. PREF - 3 GENERAL INFORMATION This section will describe functions common to all of the QSYS system programs, including the INSTALLATION AID. This section should be read by all users. It may provide a more clear understanding of the installation and operation of the system in conjunction with the more specific sections detailing each function. If a term is used in this documentation with which you are unfamiliar, you may find it in the GLOSSARY. SECURITY SYSTEM The QSYS security system provides a means of controlling access to the various functions provided by the QSYS system. It is configured through the use of security levels assigned to each user, task, and menu. Security levels might be thought of as the amount of restriction which QSYS will provide for a given function. For example, a security level of 9, assigned to a user, provides the most restriction, and a security level of 0 provides no restrictions. A user with a security level of 0 is known as a primary user. Primary users have access to all functions of the system without restriction. Some QSYS functions, for example, the QSYS Command Line and most system configuration func- tions, are only accessible to primary users. There is no limitation, other than the maximum of 24 QSYS users, on the number of users which can be assigned primary user status. Each user selects a private password for access to the system. Passwords are never displayed, even while they are being entered. They may be changed at any time, but only by the owning user. Each user is assigned a security level by a primary user. No user has the ability to upgrade his or her own security level. Task and menu security levels are similar to user security levels. A task with a security level of 0 is only accessible to primary users, and a task with a security level of 9 is accessible to all users. In general, a task or menu may only be accessed by users with a security level equal to, or below the task or menu security level. The message system treats all users equally. No user, including a primary user, can access the private messages of another user, or the private messages between users. Details pertaining to the function of the security system, as it applies to each area of QSYS operation, will be discussed in the appropriate sections of this document. GEN - 1 GENERAL INFORMATION SCREEN FORMAT ====================================== = TITLE = <-- Line 1 =------------------------------------= <-- Line 2 = = <-- = Data Area = Lines 3-22 = = <-- =------------------------------------= <-- Line 23 = PROMPT LINE = <-- Line 24 = STATUS/MESSAGE LINE = <-- Line 25 ====================================== All QSYS programs share a common display interface. Above is an abbreviated diagram outlining the significant areas of the display screen as used by QSYS. The TITLE line is used to identify the current screen name. It may be the name of a menu or the name of the function currently being performed. The screens to some similar functions may be identical except for the TITLE. The DATA AREA of the screen is, as you might expect, used for displaying the details of the function being performed. For example, in the Menu System, this area would be used to display the current menu. Similarly, in the Message System, this is where the text of the message is entered and displayed. Lines 2 and 23 are usually used as separators between the the separate sections of the screen. The PROMPT line is used to display a prompt indicating the action that currently needs to be taken by the user. The prompt may contain information pertaining to the allowable entries in the current field, or it may be used for inputting data or commands. Some error messages will display the available recovery options on this line. The STATUS/MESSAGE line serves a dual purpose. Normally, this line indicates which functions are currently available, and the keys which are used to activate them. QSYS may also use this line to display a message to the user. The message may be of an informational nature, or it may be the result of an error. Refer to the SYSTEM MESSAGES section of this document for more information on messages. GEN - 2 GENERAL INFORMATION QSYS EDITOR QSYS utilizes a keyboard input routine capable of functions including the input of only certain classes of keys, controlling the keyboard shift, formatting the input data, controlling the display attribute of the input field, and measuring the time span between keystrokes. It can manage field sizes of 0 characters a full page of text, and offers the user control similar to that of the editor used in the BASIC interpreter. This section will describe the use of, and the keys supported by the QSYS editor. - Cursor Control Keys Left Arrow - Moves the cursor one character to the left if not already at the beginning of the field. Ctrl-Left - Moves the cursor to the beginning of the previous word in a field, unless already at the first word, in which case the cursor is moved to the beginning of the current word. Right Arrow - Moves the cursor one character to the right if not already to the right of the rightmost character in a field. Ctrl-Right - Moves the cursor to the beginning of the next word in a field, unless already at the last word, in which case the cursor is moved to the end of the field. Up Arrow - Moves the cursor to the start of the previous field if one is present. Down Arrow - Moves the cursor to the start of the next field if one is present. Tab Left - Moves the cursor to the beginning of the field, unless already at the beginning, in which case it moves the cursor to the beginning of the previous field if one is present. Tab Right - Moves the cursor to the right of the last significant character of a field, unless already there, in which case it moves it to the beginning of the next field if one is present. Home - Moves the cursor to the beginning of the first field of a data entry screen. End - Signals the end of editing on a data entry screen. GEN - 3 GENERAL INFORMATION - Editing Keys Backspace - Erases the character to the left of the cursor, moves the cursor, the character at the current cursor position, and all characters to the right of the cursor position left one character. Esc - Erases the field and positions the cursor at the beginning of the field. Ctrl-End - Erases the character at the cursor position and all characters to the right of the cursor position without changing the cursor position. Ins - Toggle action key. Turns Insert mode on with the first depression and off with the next. The cursor size will change to indicate Insert mode. Insert mode causes all characters entered to be inserted at the current cursor position. Del - Deletes the character at the current cursor position and moves all characters to the right of the cursor position one character left. Enter - Terminates editing of the field. The field will be assumed to contain the value seen on the screen including any trailing spaces up to the cursor position. + - The long grey ` + ' key on the numeric keypad acts as a combination of Ctrl-End and Enter. Pressing this key erases the character at the current cursor position and all characters to the right of the cursor and terminates editing of the field. - Function Keys The programmed function keys will be referenced as F1 thru F40 where F1 thru F10 are as designated on the keyboard. The Shift keys add a value of 10, the Ctrl key adds a value of 20, and the Alt key adds a value of 30 to the values marked on the keys. In most cases, the active function keys will be displayed at the bottom of the screen. - Special Purpose Keys The Ctrl-Break sequence serves a special purpose in all of the QSYS system programs. This key can be used in any input field, at any time to sign-off the current user. However, caution should be exercised in it's usage, since it's effect is immediate, and no system action is taken to complete the current task. This key usually has the effect of aborting the current function. GEN - 4 QSYS INSTALLATION The QSYS INSTALLATION AID was designed to minimize the task of installing QSYS. For more standard equipment configurations, all that may be necessary to install QSYS is for the installer to know his or her name, and be able to make up a 5 letter password. Default options will be provided, based upon information gathered by the configuration program, for every other required field, and can be accepted by simply pressing the <ENTER> key. The installation procedure will prompt for any operator action necessary. The less standard your equipment configuration, the more complex the task of installation will become. The QSYS INSTALLATION AID has facilities for handling very complex installations, but greater demands are made on the knowledge of the installer when the complexity of the installation increases. Read the entire QSYS INSTALLATION section before attempting the first installation. This will help you to understand the capabilities of the installation procedure. It may also be helpful to run through the installation once or twice before planning the final configuration. It is possible to preview the installation without building any files if the installation is aborted, by pressing Ctrl-Break, before termin- ating step 2j. The installation procedure can be executed as often as desired. On a diskette system, the same diskettes may be used to install QSYS many times. They will be reformatted during each installation. Installation of QSYS on a PC-XT, or any system using a Winchester disk involves a little more risk. It is imperative that your disk is backed-up before attempting installation. If a trial installation is made, installing the QSYS files in a new sub-directory will be helpful if deletion of the QSYS files becomes necessary. It is not necessary to create the sub-directory prior to installation. The installation procedure will create sub-directories as needed. Be aware that all of the startup files, AUTOEXEC.BAT, CONFIG.SYS, ANSI.SYS, MEMBRAIN.SYS, and MODE.COM, plus any user defined files, will be located in the root directory. If an error occurs during the installation procedure, an error message will be displayed indicating the type of error that occurred. Refer to the SYSTEM MESSAGES section for a detailed explanation of the cause of the error, and possible recovery actions. BEFORE INSTALLATION - Backup Your System If you are installing QSYS on a Winchester drive, it is YOUR responsibility to backup your present files. Also, make sure that the root directory and any already existing directories into which QSYS files will be copied, contain no files with filenames that match the filenames of any of the QSYS files. Refer to the list of QSYS files in the PREFACE of this document. INST - 1 QSYS INSTALLATION - Backup QSYS Use the following procedure to make a working copy of the QSYS INSTALLATION and QSYS DOCUMENTATION diskettes. These copies will not only provide a measure of insurance against loss, but are necessary to provide a copy of DOS and the DOS utility files that are required by the installation procedure. 1) FORMAT a Blank Diskette Use the 'FORMAT ' command and include the '/S ' parameter so that DOS will be copied to the formatted diskette. 2) COPY the QSYS Files Use the 'COPY ' command with the global filename of '*.* ' to copy all of the QSYS files from the QSYS installation diskette to the diskette formatted in step 1. ** Do NOT use 'DISKCOPY ' ** 3) COPY DOS Files Copy the 'FORMAT.COM ', 'MODE.COM ', and 'ANSI.SYS ' files to the diskette formatted in step 1. 4) Backup QSYS DOCUMENTATION Use 'COPY *.* ' or 'DISKCOPY ' to make a backup copy of the QSYS DOCUMENTATION diskette. Store the original copies of the QSYS INSTALLATION and QSYS DOCUMENTATION diskettes in a safe place. All future references will be to the working copies made in the previous steps. INST - 2 QSYS INSTALLATION INSTALLATION 1) USER CONFIGURATION FILES The following preliminary steps in the installation process are necessary to ensure that the QSYS configuration program is able to correctly evaluate all system equipment to be used with QSYS. This is especially important in the area of storage devices, such as device drivers for other than IBM Winchester drives, emulated disks other than MEMBRAIN, which is included with QSYS, and other devices that require a 'DEVICE= ' entry in 'CONFIG.SYS ', or a setup program to be run as part of the system startup procedure. Any devices that are not defined when the installation program evaluates the system equipment may not be usable with QSYS. Steps 1a, 1b, and 1c provide an interface for user defined CONFIG.SYS and AUTOEXEC.BAT entries. 1a) CONFIG.SYS Entries The QSYS INSTALLATION diskette created in the previous steps contains a default 'CONFIG.SYS ' file containing the following entries: BUFFERS=5 DEVICE=ANSI.SYS DEVICE=MEMBRAIN.SYS This file will be used by DOS for configuration information during the installation procedure, and will then be copied to the QSYS media for use by DOS when QSYS is IPL'ed. Most installations will not require additional DOS configuration and may skip this step. However, if you desire to alter this minimum configuration, the necessary entries should be copied to a file on the installation diskette called 'UCONFIG.SYS '. The 'CONFIG.SYS ' file should not be altered. The following example illustrates how to create this file. COPY CON: UCONFIG.SYS 'Type this DOS command BUFFERS=10 'Enter the necessary entries '' ' '' ^Z 'Press F6 and <ENTER> INST - 3 QSYS INSTALLATION 1b) USEREXEC.BAT File The 'USEREXEC.BAT ' file is a mechanism for introducing user defined programs into the installation IPL sequence. This file will be called from the installation 'AUTOEXEC.BAT ', if it exists. The file specifications and parameters for programs required to install drivers for storage devices, such as emulated disks, that will be used in conjunction with QSYS, must be specified in this file on the installation diskette. The following example shows the steps necessary to create this file. COPY CON: USEREXEC.BAT 'Type this DOS command EXAMPLE.COM 'Enter the necessary entries '' ' '' ^Z 'Press F6 and <ENTER> 1c) AUTOEXEC.BAT Entries The QSYS configuration program will create an 'AUTOEXEC.BAT ' file that DOS will execute every time QSYS is booted. Any files specified in steps 1a and 1b should be copied to the installation diskette. In addition, the configuration program will prompt for the file specifications of programs or batch files that are to be included in the QSYS startup procedure. The configuration program will test for the existence of all files specified, and will not accept internal DOS commands. If this type of entry is desired in the IPL sequence, a batch file must be created on the installation diskette in this step, containing these entries. It is not good practice to specify other than internal DOS commands in a user batch file, since doing so will hinder the ability of the config- uration program to correctly evaluate the required free space on the IPL drive. In short, any files that will be used in the installation of QSYS, or in the QSYS startup procedure, must be present on the installation diskette. NOTE: It is not possible to define the correct procedure for installing every possible non-standard device available for the IBM-PC. The above interfaces are provided to handle most situations, but in some cases, the installation procedure will have to be modified in order to ensure that certain devices are usable with QSYS. The key is to be sure that any device that is to be used with QSYS is installed at the time that the QSYS INSTALLATION AID performs it's equipment determination. INST - 4 QSYS INSTALLATION 2) QSYS INSTALLATION AID The following installation procedure will create all of the system files that QSYS will require. The configuration program will prompt for the necessary information. Default data for most fields is available by leaving the field blank and pressing the <ENTER> key. Any fields that are not required will automatically be skipped. The up-arrow can be used to back up to a previous field and change an entry. In extreme cases, the Ctrl-Break sequence can be used to abort the installation. If the installation is aborted it must be restarted from step 1. 2a) Re-IPL the System Insert the backup copy of QSYS created in the previous steps into drive A. Insert media into all remaining drives if necessary. Any dual-sided diskette drives should contain diskettes formatted as 2D diskettes so that the configuration program can correctly determine the type of drive installed. Press ' Ctrl,Alt,Del ' or power the system off and then back on. The installation 'AUTOEXEC.BAT 'will begin execution. If you created a 'UCONFIG.SYS ' file in the previous steps, and this is the first time at this step, then proceed to step 2b. Otherwise, if you created a 'USEREXEC.BAT ' file in the previous steps, it will be executed now. 2b) System Configuration Check The configuration program will first check the installed hardware on your system. This equipment determination assumes that all hardware configuration switches in your system are set correctly. If the required hardware, as described in the PREFACE of this document, is found, then the QSYS logo will appear. Otherwise, an error message will be posted and the installation procedure will abort. 2c) Create 'CONFIG.SYS ' File If you created a 'UCONFIG.SYS ' file in step 1a, then it's contents and the default 'CONFIG.SYS ' entries will be combined, the 'UCONFIG.SYS ' file will be deleted, and the configuration program will auto-IPL the system, restarting the installation with step 2a. Otherwise, this step is omitted. INST - 5 QSYS INSTALLATION 2d) Resource Determination The installation diskette will be checked for the presence of the files necessary for the installation of QSYS. If any are missing, an error message will be posted naming the missing file and the installation will be aborted. If the file named in the error message was 'CONFIG.SYS ', then the default file will be recreated during termination of the configuration program and the installation may be restarted at step 1. Otherwise, the missing file must be copied to the installation diskette before restarting the procedure. 2e) Drive Configuration The configuration program will attempt to determine the type and size of all installed drives. If an error is encountered due to a drive not ready condition, the configuration program will prompt for you to install media in the drive and press <ENTER>. If the mother board configuration switches in your system indicate more drives than are actually installed, this prompt may request media for the non-existent drives. If this occurs, pressing F10 will bypass the test for the erroneous drive. F10 should not be used to bypass tests for installed drives, since doing so will render the drive unusable with QSYS. After the determination is made, a summary of the system hardware configuration is displayed, with a prompt asking if the configuration is correct. The determination procedure cannot distinguish between emulated and hardware drives, except in the case of MEMBRAIN. If all of the drives installed on your system have been determined correctly, then press <ENTER> and proceed to the next step. If any of your double-sided diskette drives contained single- sided media, you can change to double-sided media now and press the up-arrow, causing the drive determination to be repeated. Entering an 'N ' and pressing <ENTER> will display an arrow pointing to the configuration entry for the first drive which is a possible emulated drive with a prompt asking if that particular drive is an emulated drive. Entering a 'Y ' and pressing <ENTER> will change the configuration entry to indicate that this drive is emulated. Pressing <ENTER> alone will repeat the above prompt for the next possible emulated drive until all possible drives have been confirmed. The up-arrow may be used to repeat the prompt for a previous drive. After the prompt is repeated for all possible drives, you will again be asked if the configuration is correct. INST - 6 QSYS INSTALLATION 2f) Monitor Type Attempting to display color on a monochrome display attached to the Color/Graphics Display Adapter will, in some cases, degrade resolution, resulting in unreadable characters being displayed. This parameter will allow QSYS to disable color burst if necessary in order to provide the highest quality display. If you have a color monitor connected to your Color/Graphics Display Adapter, then enter a '1 ' and press <ENTER>. Otherwise, just press <ENTER> to accept the default of 0. 2g) Primary User - Primary User Name: Enter the name that the system will use to distinguish you from other users. This entry can be up to 10 characters in length. - Password: Enter a password to be used for access to the system. It must be 5 data keys. No control keys or programmed function keys are allowed. The characters will not be displayed as they are entered. 2h) File Locations The following prompts will ask you to identify where the installation procedure should locate the necessary QSYS system files. Leaving a field blank will result in the configuration program determining a default, based upon information gathered in the equipment determination. Any files that are located on MEMBRAIN will automatically increase the size of MEMBRAIN to accommodate the added file, and consequently decrease the amount of available memory for program execution. If the resulting memory size is insufficient to execute QSYS, then an error will be posted and you will be given the opportunity to re-specify the file locations. Similarly, if the total size of the files located on a particular drive exceeds the space available on that drive, then an error will be posted and a retry of the file location specifications will be available. - QSYS Path: This field identifies the drive and directory path used to locate QSYS.EXE, QSYS.SYS, SYSTEM.MNU, and the default locations for JOBQ.BAT and QLDR.COM. All path parameters are entered in the format 'd:\directory\directory... '. For example, if QSYS is to be installed on drive A, in a directory called 'QSYS ' then you would enter 'A:\QSYS '. If you want it to be installed in the root directory, then you would enter only 'A:\ '. QSYS must be located on the drive from which DOS will be booted. Only entries which specify the drive from which the installation aid was booted, or a fixed disk, are considered valid. INST - 7 QSYS INSTALLATION - QSYS Vol-id: The Volume Label of the diskette on which the files specified under QSYS Path will be installed. It can be up to 11 characters in length. If the QSYS path indicates a fixed disk, this field is bypassed. A default is given if the field is left blank. - QSYS Emulated Path: Entering a path name in this field will cause the path to be created, if necessary, and QSYS.EXE to be copied to the indicated emulated drive during 'AUTOEXEC.BAT ' execution. This allows QSYS to be reloaded very quickly when necessary, but costs memory. - JOBQ Path: The drive and directory path used to locate JOBQ.BAT and it's associated QLDR.COM file. This path must equate to either a fixed disk or an emulated drive. The default is the root directory of MEMBRAIN. - QCNFG Path: The drive and directory path used to locate the QCNFG.EXE. The specified drive must equate to a hardware drive. The default is QSYS' path. - QCNFG Volid: The Volume Label of the diskette on which QCNFG.EXE is to be installed. It can be up to 11 characters in length. If QCNFG path indicates a fixed disk, then this field is bypassed. A default is given if necessary. - QCNFG Emulated Path: Entering a path name in this field will cause the path to be created, if necessary, and QCNFG.EXE to be copied to the indicated emulated drive during 'AUTOEXEC.BAT ' execution. This allows QCNFG to be reloaded very quickly when necessary, but costs memory. - QMSG Path: The drive and directory path used to locate the QMSG.EXE, QINT.EXE, and MSGS.DAT. The specified drive must equate to a hardware drive. The default is QSYS' path. - QMSG Volid: The Volume Label of the diskette on which QMSG.EXE is to be installed. It can be up to 11 characters in length. If QMSG path indicates a fixed disk, then this field is bypassed. A default is provided if necessary. INST - 8 QSYS INSTALLATION - QMSG Emulated Path: Entering a path name in this field will cause the path to be created, if necessary, and QMSG.EXE to be copied to the indicated emulated drive during 'AUTOEXEC.BAT ' execution. This allows QMSG to be reloaded very quickly when necessary, but costs memory. 2j) User AUTOEXEC.BAT Files This section allows you to insert a message to be echoed to the display during 'AUTOEXEC.BAT ' execution on the first line of each entry, followed by the file specification and parameters necessary for DOS to execute the programs that were copied to the installation diskette in step 1c on the next line. Files named in 'USEREXEC.BAT ' in step 1b must be respecified in this step. The following example installs an in memory spooler during 'AUTOEXEC.BAT ' execution. ========================================================== = QSYS INSTALLATION AID = = ====================================================== = = 1) Loading Print Spooler = = SPOOLER.EXE parm1,parm2,etc = = 2) _ = = = = 3) = = ====================================================== = = Enter User Autoexec Loading Message = = QSYS 3.00 (C) Copyright 1984 Dennis Lee = ======================================================== = - User Autoexec Loading Message This field allows you to enter a remark that will be echoed to the screen prior to execution of the associated file specified on the following line. It may be up to 70 characters in length, or may be omitted. - User Autoexec File Specification This field allows the specification of files to be executed during the QSYS startup procedure. The entire filename and exten- sion of the file must be specified, followed by any parameters to be passed to the file. The drive and path for each file is assumed to be the IPL drive's root directory, and must not be entered. It is recommended that batch files specified in this field only contain internal DOS commands. The configuration program will not correctly evaluate the free space required on the QSYS disks for files named in a batch file, nor will these files be copied to the QSYS disks. INST - 9 QSYS INSTALLATION BASIC programs specified in this field must be specified in the format 'BASIC(A).COM filename.ext '. With this type of file, the configuration program will allocate file space on the QSYS diskettes only for BASIC(A), not for the file specified in the parameter of the command, and the file will not be copied to the QSYS diskettes. Either entry may be omitted, but if both are left blank, it is assumed that entry of user autoexec items is complete. Up to 20 messages and/or associated files may be entered, 10 on the first page, and 10 more on the second. The up-arrow may be used to back-up to a previous entry or even to the previous screen. After entry is completed, the installation diskette will be searched for each specified file. If any of the specified files are not found, an error message is displayed momentarily, and you will be asked to correct the missing file specification. 2k) Build QSYS Files Unless errors are found due to insufficient memory or file- space, the rest of the installation procedure should run to completion without intervention, except for prompts to insert diskettes as needed. The prompts will vary from one installation to the next, due to differences in system configuration and file locations. Follow the prompts on the display as the installation procedure creates the necessary files and installs QSYS on the proper media. 2l) Installation Housekeeping After installation of the QSYS files, the installation procedure will clean up the installation diskette, removing any temporary files created in the process. Only the QSYS files and and the DOS files installed in during the BEFORE INSTALLATION steps should remain. 2m) Re-IPL the System The last step of the installation procedure instructs you to press 'Ctrl,Alt,Del ' or power off and then back on. Refer to the SYSTEM STARTUP section for detailed information on the startup procedure. Read the AFTER INSTALLATION section. INST - 10 QSYS INSTALLATION AFTER INSTALLATION - Required Operating Files QSYS will expect that 'COMMAND.COM ' and any versions of BASIC that will be required to load your programs are present in the root directory of the drive from which the system is booted. On diskette systems, these may reside on any available diskette. QSYS will prompt for these files as they are required in the loading process. - Default SYSTEM MENU As a result of the installation procedure, the base menu of the system was created. This menu was named 'SYSTEM MENU ' and was located on the same drive and in the same directory as QSYS.EXE. The base menu initially contains references to the Message System and to the QSYS Configuration program modules. Although none of the QSYS system files should be relocated without the aid of the installation procedure, the menu references may be relocated as desired. Refer to APPENDIX C for technical information concerning the base QSYS menu. - MEMBRAIN Configuration The installation procedure will adjust MEMBRAIN to the minimum size necessary for operation of the QSYS system in the configuration that you have specified. It will be configured with 128 bytes/sector, 1 sector/cluster, and the minimum number of directory entries. Refer to APPENDIX A for detailed instructions on configuring MEMBRAIN to your specifications. It is not recommended that MEMBRAIN's size be adjusted downward even though free space may appear to exist. Upward adjustment will be limited by the amount of available memory in your system. QSYS may not execute dependably in less than approximately 130K. 'CHKDSK ' can be used to aid in determining the amount of free memory that may be allocated to MEMBRAIN. INST - 11 SYSTEM STARTUP Provided that QSYS is installed on the drive from which DOS boots at power-up, the following sequence of events will occur. o DOS loads + Initializes file buffers as defined in 'CONFIG.SYS ' + Loads and initializes 'ANSI.SYS ' + Loads and initializes 'MEMBRAIN.SYS ' + Loads and initializes user device drivers if installed + Begins execution of 'AUTOEXEC.BAT ' o 'AUTOEXEC.BAT ' executes + Sets Video mode + Tests for IPL Resources - Posts error if resources are unavailable - If resources are missing from removable media then prompts for proper diskette, waits for operator intervention, and restarts 'AUTOEXEC.BAT ' - If resources are missing from fixed media, or if the file is missing from the IPL drive, then terminates 'AUTOEXEC.BAT ' + Sets the system environment - Defines QSYS file locations and volume labels - Sets cursor to backspace character + Executes QINT.EXE - Initializes MSGQ and QSYS data areas - Initializes QSYS interrupts + Executes user defined startup programs + Copies QSYS files to emulated drives if necessary - Makes sub-directories as necessary + Executes Message Reorganization Procedure - Allows setting of system date and time if necessary - Reorganizes Message File - Puts today's messages in MSGQ + Executes JOBQ.BAT o JOBQ executes o Loads QSYS.EXE - Clock/Calendar appears awaiting sign-on STRT - 1 CLOCK/CALENDAR The CLOCK/CALENDAR screen is the default screen of QSYS, and will be displayed anytime that a user is not signed-on to the system. This screen will be the first QSYS screen displayed after the startup proc- edure executes. It can be reached from the MENU SYSTEM by pressing F10, or from any other QSYS screen by pressing Ctrl-Break. Following is a a summary of the functions available from the CLOCK/CALENDAR. - Calendar Browsing The range of DOS' calendar is 1/1/1980 to 12/31/2099. In the interest of consistency, this is also the range of the calendar used in QSYS. F1 - Moves the Calendar back one month. F2 - Moves the Calendar forward one month. F3 - Moves the calendar back continuously one month at a time until another function key is pressed. F4 - Moves the calendar forward continuously one month at a time until another function key is pressed. F5 - Prompts for you to enter the month and year to be displayed. F6 - Returns the calendar to the current month and year. F10 - Terminates F3,F4,F5, and F7 functions - Display the MSGQ F7 - A summary of Messages for the current system date will be displayed. If no Messages are in the MSGQ, then an informational system message will be displayed. - MSGQ Alarm Control F17 - Toggle action key that switches the current state of the MSGQ Alarm. A 'note ' symbol is displayed on line 25 of the screen when the alarm is activated. When activated, the MSGQ Alarm will sound two loud, high- pitched tones once per minute when a message is due. This control is reset to the default state as set by the 'CLOCK/CALENDAR Configuration ' whenever the CLOCK/CALENDAR screen is exited. - Sign-on Entering your password allows access to the QSYS menu system. If you are the last user that was signed-on to the system, then QSYS will return you to the same place in the menu structure as you were when you signed-off. Otherwise, QSYS will return to the base QSYS menu. CLK - 1 MENU SYSTEM - DESCRIPTION The QSYS menu system is the interface between the system users and DOS. It provides a means of cataloging any task that DOS 2.X is capable of executing. A task can be a program, batch file, or DOS command. The menu system allows any task to be executed immediately, or placed in the JOBQ for execution as a batch, by simply selecting an option from any of an unlimited number of user defined menus. The menu system is tree-structured in design, similar to the DOS tree- structured directory system. This design allows totally free-form creation of menus to suite almost any need. The following example menu system illustrates the tree-structured concept. ..................... : SYSTEM MENU : :-------------------: : Parent of : : MENU 1,2 & 3 : :...................: __________________________|__________________________ ..........|.......... ..........|.......... ..........|.......... : MENU 1 : : MENU 2 : : MENU 3 : :-------------------: :-------------------: :-------------------: : Child of SYSTEM : : Child of SYSTEM : : Child of SYSTEM : : Parent of MENU 1A : : Parent of 2A & 2B : : Parent of MENU 3A : :...................: :...................: :...................: ..........|.......... | ..........|.......... : MENU 1A : | : MENU 3A : :-------------------: | :-------------------: : Child of MENU 1 : | : Child of MENU 3 : : : | : : :...................: | :...................: ________________|________________ ..........|.......... ..........|.......... : MENU 2A : : MENU 2B : :-------------------: :-------------------: : Child of MENU 2 : : Child of MENU 2 : : : : : :...................: :...................: The above example illustrates only a small part of one possible structure. The basic concept of the QSYS menu system is the relation- ship between 'parent ' menus and their 'children '. This relationship forms a 'generation '. For example, in the illustration above, the SYSTEM MENU is the 'parent ' of MENU 1, MENU 2, and MENU 3. Together these menus form a 'generation '. Even though MENU 1,2, and 3 each have 'children ' of their own, the children are outside of SYSTEM MENU's generation, and may not be directly affected by changes to SYSTEM MENU. Similarly, MENU 2A and MENU 2B are children of MENU2, and together these three menus form a separate generation. All of the generations put together form a sort of menu tree. This relationship accounts for the term 'tree-structured '. MENU - 1 MENU SYSTEM - TASK SELECTION The primary function of the menu system is to provide the user with a quick and easy method of loading and executing tasks. This function is accomplished in one of two ways. Once a task has been defined on a QSYS menu, using the MENU EDITOR, it can be selected for execution by simply entering the number to the left of the task name. In addition to this method, tasks may be executed directly from the QSYS command line, which is available on every menu. Refer to the detailed explanation of the QSYS Command Line in this section for more information concerning the use of the command line. All tasks selected, regardless of which method is used, are executed through the JOBQ either in immediate mode or in batch mode. With the JOBQ in 'Queue ' or batch mode, an informational message will be momentarily displayed indicating the status of the task in the JOBQ. In 'Execute ' or immediate mode, the task is placed in the JOBQ, and QSYS immediately passes control back to DOS for execution of the JOBQ. Refer to the JOBQ section for detailed information concerning the JOBQ and task execution control. - MENU SELECTION The selection of menus is accomplished similarly to the selection of tasks. A menu that has been pre-defined using the MENU EDITOR, can be selected from it's parent menu by entering the number to the left of the menu name, while viewing the parent menu. If a change of media is required to access the selected menu, QSYS will prompt for it by volume label. The name of the menu, as displayed on the parent menu, will be used in the title line at the top of the selected menu. A menu can also be accessed directly from the QSYS command line by entering the drive, path, and filename of the menu. In this case, QSYS cannot prompt for a change of diskettes, if one is required. Instead, an error message indicating that the file was not found is issued, and the request is ignored. If the requested menu is found, the filename will be used in the title line followed by the word 'MENU '. Regardless of how a menu was accessed, the F9 key will return you to the parent menu, unless the current menu is the base menu. F19 will return you to the base QSYS menu from any other menu. MENU - 2 MENU SYSTEM - AVAILABLE FUNCTIONS The bottom line of every menu lists, in an abbreviated format, most of the functions available from the menu system. Following is a short explanation of each function, and a reference to the section containing more detailed information on the use of that function. KEY FUNCTION DESCRIPTION --- -------------------- F7 If messages are available, pressing F7 will display a summary of the MSGQ. Otherwise, an informational message will be displayed to inform the user that the MSGQ is empty. Refer to the MSGQ section for more information. F8 If tasks have been placed in the JOBQ, then pressing F8 will display the contents of the JOBQ and activate the JOBQ functions. Otherwise, an informational message is displayed to inform the user that the JOBQ is empty. Refer to the JOBQ section for more information. F9 Returns to the current menu's parent menu. If this menu has no parent, then the request is ignored. F10 Signs-off the current user and returns to the Clock- Calendar. F18 This is a toggle action key which toggles the current mode of the JOBQ. The current mode is displayed on line 25 as either 'F18 Execute ', if the JOBQ is in immediate mode, or 'F18 Queue ' if tasks selected for execution are to be executed as a batch. Refer to the JOBQ section for more information. F19 Returns to the base QSYS menu, regardless of the current position in the menu system. F39 Invokes the MENU EDITOR, if the current user has primary user security. This option is not displayed on line 25. Refer to the MENU EDITOR section for more information. F48 If tasks have been sent to the JOBQ, then pressing F48 will release the JOBQ for execution. Otherwise, an informational message is momentarily displayed, and the request is ignored. Refer to the JOBQ section for more information. MENU - 3 MENU SYSTEM - QSYS COMMAND LINE The QSYS command line is similar to the DOS command line. It provides a means of executing tasks that are not defined in the menu system. Any DOS command that can be executed from the DOS command line can be entered on the QSYS command line. In addition, batch commands and labels may be entered on the QSYS command line for use in the JOBQ. Refer to the JOBQ section for information concerning the use of DOS batch file commands and labels in the JOBQ. Since any task or menu can be directly accessed from the command line, it is necessary that the QSYS security system assume that all tasks and menus accessed in this manner have a security level of 0. This restricts the use of the QSYS command line to only primary users. The format of commands entered on the QSYS command line is the same as that of the DOS command line with a couple of exceptions. The following example will illustrate these differences. - Executing '.COM ', '.EXE ', or '.BAT ' Files EXAMPLE: Suppose that you wanted to execute a program named 'PROG1.EXE ' from drive A, in a sub-directory named 'SUBDIR1 '. On the DOS command line you would insert the proper diskette, if necessary, and enter the following commands. CD A:\SUBDIR1 ' Change to the proper directory PROG1 ' Execute the program On the QSYS command line you would enter the following command. A:\SUBDIR1\PROG1.EXE QSYS will notify you if either the sub-directory or the requested program is not found, and allow you to change media as necessary. QSYS will then change to the indicated sub-directory, and load the requested program. The significant difference is, that all requests for executing programs, batch files, and external DOS commands, that are not resident in the root directory of the default drive, are entered in the format illustrated below. d:\directory\filename.ext parameters | | | | | | | Parameters to be passed | | Filename and extension | Directory path Drive MENU - 4 MENU SYSTEM NOTES: 1) QSYS will always assume the default drive, if one is not specified, except when loading 'COMMAND.COM ', 'BASIC.COM ', or 'BASICA.COM ', which are assumed to be on the drive from which QSYS was booted, regardless of which drive is the default. 2) QSYS will assume the root directory, if one is not specified, regardless of which directory was last used. The directory path may include multiple sub-directory names, but must always be specified starting at the root directory. 3) QSYS will assume an extension of '.BAT ', if one is not specified. Therefore, it is good practice to always specify a filename extension. 4) Note 3 does not apply to external DOS commands. QSYS knows, and will automatically add the proper extension, if necessary, to all utilities supplied with DOS. - Executing BASIC Programs The format of commands necessary to load BASIC programs remains identical to that of the DOS command line, since the above conventions are also used by DOS. It is important to note however, that QSYS will assume that BASIC or BASICA, whichever is specified in the command, will always reside in the root directory of the drive from which DOS was booted. The following example illustrates the format used for executing BASIC programs. EXAMPLE: Suppose that you wanted to execute the BASIC program 'PROG2.BAS ' from drive B, in a sub-directory named 'SUBDIR2 ', that required BASICA (advanced BASIC). On either the QSYS or DOS command lines you would enter the following command. BASICA B:\SUBDIR2\PROG2 Again, QSYS will assume that 'BASICA.COM ' can be found in the root directory of the drive from which DOS was booted, and no drive or directory path should be specified. NOTES: 1) QSYS will assume an extension of '.BAS ' for BASIC programs, unless one is specified. 2) The '.COM ' extension for BASIC or BASICA need not be entered. MENU - 5 MENU SYSTEM - MENU EDITOR The MENU EDITOR provides functions for adding and deleting tasks from the currently displayed menu, as well as for creating new menus and deleting existing menus from the menu system. The MENU EDITOR is accessed by pressing F39 (Ctrl-F9) at any menu. Only primary users are allowed access to the MENU EDITOR. This is necessary to prevent unauthorized access to existing tasks or menus by creating a duplicate entry with a lower security level. Upon entering the MENU EDITOR, the title line will display the current menu name, plus the word 'EDITOR ' to identify the function currently being performed. You will be prompted to enter the selection number of the menu item to be edited. - Task or Menu Descriptors Before discussing the functions available in the editor, it is important that you understand what kind of information is associated with a menu entry. The following paragraphs describe each of the four fields that make up a task or menu descriptor. MENU NAME: This is the name of the task or menu as it is to appear on the menu. It may be up to 30 characters long, and any displayable characters may be used, including graphics characters. For tasks, this name describes the task that is performed when this menu entry is selected for execution. It has no meaning to QSYS. For menus, this name is used by QSYS for the title line of the menu when displayed. FILESPEC: This field describes to QSYS, the drive, directory path, and filename of the task or menu file that this menu entry describes. The format for this entry is the same as that of the QSYS command line. A menu file entry is distinguished from a task entry by the use of an extension of '.MNU ' on the filename. If this descriptor describes another menu file, then a filespec indicating the use of an emulated drive will result in an error. QSYS will not allow it's menus to be located on emulated drives. Up to 127 characters may be used to describe the filespec and associated parameters. Refer to QSYS COMMAND LINE in this section for details about file specifications. MENU - 6 MENU SYSTEM VOLUME ID: If the drive specified in the filespec entry indicates removable media, such as a diskette drive, then QSYS will prompt for the volume label of the media on which this file can be located. This allows QSYS to prompt for the proper media by name if the file is not found, thus relieving the users from having to remember the location of files cataloged in the QSYS menu system. Entering the global search character '* ', will tell QSYS not to test for the Volume ID of the media associated with this file, allowing the same file to be accessed from different media. This should only be used if necessary, since it disables QSYS' ability to prompt for the required media by name. Up to 11 characters may be used in the Volume ID. Any volume label that is valid in DOS may be used in this field. QSYS will not allow this field to be left blank if the specified drive uses removable media. SECURITY LEVEL: This is the security level required by the active user to access this menu entry. This field allows restricted access to tasks or even entire menus to those users with a security level equal to or below the security level specified. Refer to SECURITY SYSTEM in the PREFACE for a description of the QSYS security system. - General Information Once the MENU EDITOR has been entered using F39, QSYS will prompt for the number of the menu entry to be edited. Pressing F10 in this field will terminate the editor and return you to task selection mode and the command line. Selecting a menu entry, while in editor mode, begins editing of that entry, and the functions available are covered in detail in the following sub-sections. Whenever a task or menu descriptor is either added to a menu, or or an existing descriptor is edited, QSYS will prompt for the fields that make up the task or menu descriptor. The up-arrow may be used to back up to a previously entered field, or out of the selected entry. Simply pressing the <ENTER> key will proceed to the next field without altering the contents of the current field. As in all QSYS data fields, what you see on the screen is what you've got in the field, but no data is actually changed in the menu file until the 'SECURITY LEVEL ' field has been entered. This allows changes to an entry to be nullified by backing out of the entry using the up-arrow. MENU - 7 MENU SYSTEM - Adding Descriptors A task or menu descriptor is added to the currently displayed menu by selecting a blank menu entry and entering the descriptor fields as QSYS prompts for them. After the last field has been entered, QSYS will update the menu file to include the added descriptor, and prompt for the next menu entry to be edited. Note that adding a descriptor for a new menu does not create the menu. After the descriptor has been added, proceed to 'Creating a New Menu ' for the steps necessary to create the menu file. - Editing Existing Descriptors A task or menu descriptor can be edited (changed) by selecting it's menu entry number. QSYS will display the current contents of each field and allow changes. After the last field has been updated, the new descriptor will be written to the menu file. Note that altering a descriptor will not change the location of a task or menu file. The actual location of the file must be changed using the DOS 'COPY ' and 'ERASE ' commands from the command line to copy the file to it's new location, and to delete the old file. If the descriptor is a menu descriptor, refer to 'Relocating a Menu '. - Deleting Descriptors A task or menu descriptor is deleted by selecting it's menu entry number and blanking the 'MENU NAME ' field by pressing the '+ ' key on the numeric keypad or by holding down the Ctrl key and pressing the End key while the cursor is positioned at the beginning of the field. QSYS will then ask for confirmation before deleting the entry. Entering a 'Y ' will delete the descriptor. Any other key will cause QSYS to re- display the original contents of the field and abort the delete. Note that filling the field with spaces does NOT blank the field. Note also, that deleting a descriptor does not delete the task or menu file. Refer to 'Deleting a Menu ' if deletion of a menu file is desired. Tasks must be erased using the DOS 'ERASE ' command from the command line. - Changing the Current Menu Since the editor assumes that selection of a menu entry is for the purpose of editing the descriptor, a mechanism is provided for changing the current menu without exiting the editor. This is accomplished by first selecting the desired menu file's descriptor from the current menu, inserting the media containing the menu file, if necessary, and pressing the F9 Menu key. In the event that the requested menu file is not found, the editor will ask if you want to create this menu. Type 'N ' to abort the create procedure and retry the operation using the correct media. MENU - 8 MENU SYSTEM - Creating a New Menu Creating a new menu requires that the descriptor has already been added to the current menu using the procedure outlined under 'Adding Descriptors '. After this procedure has been performed, select the descriptor for editing, insert the media to contain the new menu file, if necessary, and press the F9 Menu key. QSYS will check the directory of the target drive for any files whose names match the requested menu name. If a file is found, the create procedure is aborted, and QSYS will attempt make this file the current menu file. If no matching files are found, then QSYS will momentarily display a message indicating this fact and ask you to confirm that the new menu file should be created. Responding to the prompt with a 'Y ' will create the new menu file, and the newly created file will become the current menu. Any other response will cancel the create procedure and editing of the current menu will resume. - Deleting a Menu The current menu may be deleted by pressing the F6 Delete key only after all descriptors have been deleted using the procedure discussed under 'Deleting Descriptors '. QSYS will ask for confirmation before deleting the requested menu. Any response except 'Y ' will abort the delete procedure. After deletion of a menu, the parent menu will become the current menu. The base menu cannot be deleted under any circumstances from within QSYS. Refer to APPENDIX C for information concerning changing the base menu. - Relocating a Menu QSYS Version 3.0X does not directly support the relocation of task or menu files. Extreme caution should be exercised in the relocation of menu files. Parent menus cannot be safely relocated, since pressing F9 at any of the children will result in QSYS attempting to back up to a non-existent member of that generation of menus. Entire branches in the menu system's tree-structure could be rendered unreliable. It is possible to relocate a parent menu file by recreating it, and all of it's children. It should only be necessary to recreate one generation of menus in order to preserve the integrity of the menu system. MENU - 9 JOBQ - JOBQ Description The JOBQ is a dynamic batch file from which all other programs, batch files, and commands are located and executed. QSYS executes all tasks through this facility. The JOBQ can operate in one of two modes, as controlled from the menu system, using the F18 function key. In immediate or 'Execute ' mode, any task selected from a menu, or entered on the QSYS command line, is executed immediately. In batch or 'Queue ' mode, up to 20 tasks selected for execution, are stacked, allowing a batch of tasks to be executed sequentially with little or no operator intervention. In either mode, the JOBQ will automatically reload QSYS after the last task in the queue has terminated. After the JOBQ is released for execution, a QSYS module called QLDR.COM provides resource availability services, such as prompting for media changes as required, supplies the loading services required for executing batch files and BASIC programs, as well as providing error recovery routines. QLDR also allows extensive user control over JOBQ execution, including the ability to re-execute previous tasks, cancel tasks in the JOBQ awaiting execution, cancel the JOBQ and return to QSYS, or call the DOS command processor to execute any other task while the JOBQ is temporarily suspended. - Special JOBQ Commands - EXIT The EXIT command terminates QSYS and passes control to the DOS command line. QSYS can be restarted by invoking the JOBQ. QSYS should never be invoked directly, since doing so will disable all JOBQ execution functions. - QLDR jt,d:,volid,path,filename.ext,parms The QLDR command causes QLDR.COM to be invoked from the JOBQ directly. Refer to 'JOBQ Execution Services ' and APPENDIX B for detailed information concerning QLDR. - Use of DOS Batch File Commands and Labels in the JOBQ Since JOBQ.BAT is a DOS batch file, it is also possible to inter- mix DOS batch file commands and labels with other tasks, providing even greater user control. QSYS reserves two labels for it's own use in the JOBQ. The first consists of the word 'JOB ' plus a number from 00 to 20. The second is the label ':END '. Refer to your DOS manual for detailed information on the use of DOS batch file commands and labels. - Use of QLDR.COM in User Batch Files Refer to APPENDIX B for technical information concerning the use of QLDR.COM in your own batch files. JOBQ - 1 JOBQ - Pre-Release JOBQ Functions The following functions are available only when the JOBQ is in 'Queue ' mode. These functions are made available to the user through the JOBQ screen. The JOBQ screen is accessed by pressing F8 at any QSYS menu. From this screen, tasks in the JOBQ can be viewed, deleted, or their sequence of execution changed before the JOBQ is released. Following is a list of the functions available. - PgUp or PgDn If more entries are in the JOBQ than can be displayed on one screen, the PgUp and PgDn keys will allow you to move forward and backward from page to page as necessary. In the event that JOBQ entries are deleted to the point that all entries can be displayed on one screen, the PgUp and PgDn keys will be deactivated. - F5 Change Sequence Press F5, enter the current sequence number of the JOBQ entry to be moved, a dash (-), and then the sequence number you want it moved to. The JOBQ entry will be removed from it's current position and inserted immediately before the the designated target entry. The screen will be updated and the cursor will return to the command line awaiting the next command. Any error in the sequence number entries, including an empty JOBQ entry specified as either source or target will produce an error message momentarily and then the sequence number entries may be retried. - F6 Delete After pressing F6, QSYS will prompt for the sequence number of the JOBQ entry you would like to delete. After you enter the sequence number, QSYS will echo the number you have entered and ask you to confirm the entry. If the number is correct enter a 'Y ' and press <ENTER>. The entry will be deleted, the screen updated, and the cursor will return to the command line awaiting the next command. If the number is not correct, any entry besides 'Y ' will cancel the delete command. If an invalid sequence number is entered, an error message will be displayed momentarily and then the sequence number entry may be retried. - F38 Release JOBQ Passes control to DOS for execution of the JOBQ. - F10 End Returns you to the menu system. JOBQ - 2 JOBQ - JOBQ Execution Services A QSYS module named QLDR.COM provides services for checking the existence of all files that are placed in the JOBQ before allowing DOS to attempt execution. This allows QSYS to prompt for proper media when possible, and to alert the operator of missing resources and provide error recovery for those conditions that would otherwise cause JOBQ task execution to be aborted without user control. If an error occurs, a message indicating the operator action that needs to be taken, or indicating the condition that caused the halt is posted, followed by the following menu. 1) Re-run Previous Task 2) Cancel Current Task 3) Cancel the Batch File 4) DOS Command Processor Press <ENTER> to Continue or Select Option: _ Note that option 4 is only available to primary users. Options are selected from the menu by entering the number of the desired option. The <ENTER> key is not required for options 1-4. All other keys are ignored. The following chart explains each available option. <ENTER> - Continues execution of the JOBQ, after the error condition which caused the halt is corrected. 1 - Re-executes the previous task in the JOBQ. 2 - Cancels the current task, and continues execution of the JOBQ with the next task in the queue. 3 - Cancels the entire JOBQ and returns to the QSYS menu system. 4 - Temporarily suspends JOBQ execution, and loads the DOS Command Processor. While in the DOS command processor, any program, batch file, or DOS command can be executed. Entering the 'EXIT ' command will exit DOS, re-display the option menu, and allow further option selection, including continuation of the JOBQ at the point at which it was interrupted. - JOBQ Execution Control All options available due to an error condition, as explained under 'JOBQ Execution Services ', are also available through a user JOBQ interrupt mechanism provided in QLDR. Pressing the Esc key as a task is terminating, will activate the user interrupt. QLDR will post a message, indicating that the halt is a result of a user request, followed by the option menu. All options listed on the menu are avail- able. It is possible to move forward or backward several tasks within the JOBQ by selecting the appropriate option and immediately pressing the Esc key again to re-display the option menu. Each time QLDR halts it will display the current task to be performed, allowing the user to track the current position within the JOBQ. JOBQ - 3 MSGQ The MSGQ is a data area in storage initialized by QINT and main- tained by QMSG. This data area contains information about messages that will come due during the current system date. A summary of the contents of the MSGQ can be viewed from either the CLOCK/CALENDAR or from any menu in the QSYS menu system by pressing F7. You do not have to be signed-on to view the MSGQ summary. This screen is meant to be a quick reference window into the MSGQ. Message text cannot be displayed from this screen. The MSGQ is listed in chronological order, with those messages that are currently due, displayed in the highlighted attribute, while those messages still pending are displayed in the normal foreground attribute. The summary lists the message recipient, the time, in 24 hour format, that the message is due, and the record number of the message in the MSGS.DAT file. The message text cannot be displayed from this screen. An active clock is also displayed on line 23 to aid in the evaluation of the displayed information. This clock is always displayed in 24 hour format, regardless of QSYS system clock config- uration, in order to remain consistent with the message time format. In the event that no messages are pending for the current date, pressing F7 will trigger an informational message indicating that the MSGQ is empty. - Available Functions PgUp or PgDn If more messages are pending than can be displayed on one screen, the PgUp and PgDn keys will be activated allowing you to move forward and backward from one page to another as necessary. F10 will return you to the screen from which you gained access to the MSGQ screen. MSGQ - 1 MESSAGES - Description The QSYS message system provides personal calendar functions for each QSYS user, as well as facilities for message exchange between users. All messages are confidential between the message sender and the intended recipient of the message. No other user, including the primary users, are allowed access to messages not intended for them. Up to five 'targets ' may be specified per message. A 'target ' is a group of fields specifying the recipient of the message, the date and time that the message is due, and a frequency, used to automatically update the target date and time, once the message has been displayed. The five target specifications may, for example, be used to send the same message to five different users simultaneously, or to the same user at five different dates and times, if desired. Each message may contain up to three lines of text. Information indicating the sender of the message, and the date and time that the message was sent or last updated is maintained by the system. QMSG.EXE provides routines for entering and editing messages, displaying and previewing messages, reorganizing the message file, and updating the MSGQ. Refer to the MSGQ section for information pertaining to the contents of the MSGQ. QSYS also incorporates an interrupt driven message alarm system, to allow monitoring of the MSGQ concurrently with all other system tasks. QSYS will sound a subtle, but distinctive tone once per minute while messages are due. The alarm system is designed not to interrupt the use of the speaker by other applications. QINT.EXE provides the necessary routines for initialization of the MSGQ, and for all MSGQ monitoring and alarm functions. - QMSG.EXE Loading Options QMSG incorporates it's own function menu, allowing access to all message system functions from within the program. It is also possible to access each function directly by passing the menu option number to QMSG using a command line parameter. For example, 'DISPLAY MESSAGES ' is option 1 on the Message Menu. The message display function can be directly accessed, bypassing the Message Menu, by appending a '1 ' to the command line used to load QMSG.EXE. This is illustrated in the default base QSYS menu created by the installation procedure. Refer to QSYS COMMAND LINE and MENU EDITOR in the MENU SYSTEM section for more information on QSYS command and filespec format. - Common Editing Features All cursor control and editing keys, described in QSYS EDITOR in the GENERAL INFORMATION section, are active while entering or editing a message. In particular, the <End> key can be used in any data field to terminate the editing function and update the message file. All data is checked for validity as it is entered. If invalid data is entered, an error message will be momentarily displayed on line 25, and QMSG will force re-entry of the field. MSG - 1 MESSAGES - Message Data Fields Before discussing the functions available in the message system, it is necessary to understand the fields that make-up a message record. Following, is an explanation of the contents of each of these fields. RECIPIENT The name of the QSYS user for which this message is intended. DATE The date on which the recipient, named in the associated target entry, is to be notified of the message. May be entered in any valid DOS format, but must be equal to, or greater than, the current system date. TIME The time of day, in 24 hour format, at which the recipient, named in the associated target entry, is to be notified of the message. May be entered in any valid DOS format. However, this field, and the associated date, must not be prior to the current system date and time. FREQUENCY The frequency at which the recipient, named in the associated target entry, is to be notified of the message. The frequency is entered as a number, up to three digits, followed by a time period specifier. The following table shows the valid time periods. MN - Minutes HR - Hours DY - Days WK - Weeks MO - Months YR - Years For example, '3DY ' would increment the target date which caused the message to be due, by three days when the associated message was displayed by the recipient using the DISPLAY function. An entry of '10WK ' would automatically make the message come due in another 10 weeks after being displayed. Time periods may not be combined. A blank frequency field will cause the associated target entry to be deleted when the message is displayed. MESSAGE The actual text of the message. Up to three lines of text can be entered. The keyboard will automatically be shifted into lower case for this field. MSG - 2 MESSAGES - MESSAGES MENU The Messages Menu currently contains the following 5 options. 1) DISPLAY MESSAGES Allows the active user to display only those messages which are currently due. 2) PREVIEW MESSAGES Allows the active user to display messages that are pending for the current system date. 3) ENTER NEW MESSAGES Allows the active user to enter new messages into the message file. 4) SEARCH-EDIT MESSAGES Allows the active user to search, delete or update messages which he has sent or in which he is named as a recipient. 9) FILE REORGANIZATION Reorganizes the message file and updates the MSGQ. QMSG.EXE may be terminated from the Messages Menu by pressing F10. Ctrl-Break will terminate QMSG, sign-off the current user, and return to the Clock/Calendar. - HELP Facility The F7 key can be used from any command line or data field in the message system to display a help screen. This screen provides the current time, in the 24 hour format required for messages, calendar browsing functions, identical to those of the Clock/Calendar, to aid in entering message target dates, and a list of the current QSYS user names. Refer to the CLOCK/CALENDAR section for detailed information concerning the use of calendar browsing functions. F10 terminates the help screen, and returns you to the beginning of the field in which help was requested. MSG - 3 MESSAGES - DISPLAY MESSAGES Displays only those messages which are currently due for the active user. Pending messages in the MSGQ are not accessible through this function. If no messages are due for the current user, an infor- mational system message is posted to the active screen. - Available Functions <ENTER> or Ctrl-<ENTER> Updates the target entry which caused the message to be due, according to the instructions contained in the 'FREQUENCY ' field. If no update frequency is specified, the associated target entry will be deleted. The next message in the MSGQ, due for the active user, will then be displayed. If no more messages are available, an informational message is displayed to notify the user, and the DISPLAY function is terminated. F5 - EDIT Allows editing of only the target entry which caused the message to be due. After the update frequency field has been updated, or the <End> key is pressed, the EDIT function will terminate, the message file will be updated, and processing continues as described in the <ENTER> function. F7 - HELP Pressing F7, either on the command line or in a data field, will invoke the HELP facility. F9 - MENU Terminates the DISPLAY function and returns to the Messages Menu. This option differs from F10 only when the original access to QMSG was not through the Messages Menu, in which case, F9 will force a return to the menu so that another selection can be made. F10 - END Terminates the DISPLAY function. If QMSG was originally accessed through the Messages Menu, then the menu will be re- displayed, otherwise, QMSG is terminated. MSG - 4 MESSAGES - PREVIEW MESSAGES Displays only those messages which are pending or due in the MSGQ for the active user. If no messages are in the MSGQ for the current user, an informational system message is posted to the active screen. - Available Functions <ENTER> Proceeds to the next message pending in the MSGQ for the active user, if one is available. No action is taken on the currently displayed message. Ctrl-<ENTER> Functions as described under 'DISPLAY '. Temporarily switches to DISPLAY mode for this message. F5 - EDIT Functions as described under ' DISPLAY '. F7 - HELP Functions as described under ' DISPLAY '. F9 - MENU Functions similarly to F10 except that return to the Messages Menu is mandatory. F10 - END Terminates the PREVIEW function. If QMSG was originally accessed through the Messages Menu, then the menu will be re- displayed, otherwise, QMSG is terminated. MSG - 5 MESSAGES - ENTER NEW MESSAGES Allows entering of new messages into the message file. If messages are entered for the current system date, the MSGQ is also updated. Refer to 'Common Editing Features ' and 'Message Data Fields ' in this section for more information. The command level functions described below are available in every data field. - Available Functions F7 - HELP Functions as described under ' DISPLAY '. F9 - MENU Functions similarly to F10 except that return to the Messages Menu is mandatory. F10 - END Pressing F10 will abort the record currently being entered. Information already entered in the current record will be lost. If the original access to QMSG was through the Messages Menu, then the menu will be re-displayed, otherwise, QMSG will be terminated. MSG - 6 MESSAGES - SEARCH/EDIT Allows direct access to existing records in the message file by record number, or sequential access to the file through the use of browsing functions similar to those used in the Clock/Calendar. Users are only allowed access to those records which they entered into the message file, and those records in which they are named as a recipient. Once the desired record is displayed, it may be edited, or the record may be deleted. The MSGQ is automatically updated to reflect any pertinent changes. - Available Functions F1 - RECORD ADVANCE Advances to the next sequential record in the file to which the active user is allowed access, unless already at the last record. F2 - RECORD BACKSPACE Record backspaces to a previous record in the file to which the active user is allowed access, unless already at the first record. F3 - SCAN FORWARD Continuously record advances until another function key is pressed, or until the end of file. Records to which the active user is denied access are not displayed. F4 - SCAN BACKWARD Continuously record backspaces until another function key is pressed, or until the beginning of file. Records to which the active user is denied access are not displayed. F5 - EDIT Allows full screen editing of the message record currently displayed. The updated record is written to the file after the text of the message is entered or the <End> key is pressed. The message time/date stamp and name of the sender are updated. F6 - DELETE Allows deletion of the currently displayed record from the message file. The message text is blanked and the record will be removed from the file during the next file reorganization. MSG - 7 MESSAGES - SEARCH/EDIT (continued) F7 - HELP Functions as described under ' DISPLAY '. F9 - MENU Functions similarly to F10 except that return to the Messages Menu is mandatory. F10 - END Pressing F10 will abort the record being edited. Changes will not be written to the file. If the SEARCH/EDIT function was orig- inally accessed through the Messages Menu, then the menu will be re-displayed. Otherwise, QMSG will be terminated. - SET DATE & TIME This screen only appears during the system startup procedure, and then, only if the system date and time have not already been set by a clock feature. All line editing functions are activated including the up and down arrows. F7 HELP is active to assist in setting of the date. F10 END is disabled. - FILE REORGANIZATION This procedure is executed automatically during system startup or at the first sign-off following a change in the system date. You may, on occasion, catch this procedure running at midnight when the system date rolls over to a new day. Reorganization of the message file is totally automatic and will require no operator intervention unless a system error occurs. DO NOT INTERRUPT IT !!! Reorganization of the message file requires free space, equal to the size of the message file, to be available on any installed drive. QMSG will evaluate the available space on each installed drive that is in a ready state, and select the fastest possible device. This procedure sorts the target entries within each record by date and time, deleting those target entries containing a recipient name not currently in the QSYS user list. Records with no active targets are deleted from the message file. Pointers to those records with a target date equal to, or before, the current system date are placed in the MSGQ. If the target date is prior to the system date, then the time is entered into the MSGQ as '00:00 '. This has the effect of making the message due immediately. At termination, if this procedure was invoked from the Messages Menu, then the menu will be re-displayed. Otherwise, QMSG will be terminated. MSG - 8 QSYS CONFIGURATION - Description In order to simplify the installation procedure, default options are taken for as many of the QSYS configuration parameters as possible. The installation aid configures only those parameters necessary for the system hardware on which QSYS is installed. QCNFG.EXE allows real-time configuration of the system parameters that make QSYS fit the operating environment in which it is to be used. Facilities are provided for user control, and screen, keyboard, and clock configuration. All changes to the configuration made in QCNFG are effective immediately, and effect all applicable QSYS program modules. Any alterations to configuration parameters are written to QSYS.SYS when QCNFG terminates. If QSYS.SYS is not available at that time, QCNFG will prompt for the proper media. It is possible to abort all changes by terminating QCNFG using the Ctrl-Break sequence. The QSYS security system restricts access to some QCNFG functions altogether, and merely controls the way which other functions perform. The following sub-sections detail the operation of each function. - QCNFG.EXE Loading Options QCNFG incorporates it's own function menu, allowing access to all configuration functions from within the program. It is also possible to access each function directly by passing the menu option number to QCNFG using a command line parameter. For example, 'USER CONTROL ' is option 1 on the Configuration Menu. The User Control function can be directly accessed, bypassing the Configuration Menu by appending a '1 ' to the command line used to load QCNFG.EXE. This is illustrated in the default base QSYS menu created by the installation procedure. Refer to QSYS COMMAND LINE and MENU EDITOR in the MENU SYSTEM section for more information on QSYS command and filespec format. - Configuration Menu The Configuration Menu currently contains the following options. 1) USER CONTROL MENU 2) KEYBOARD/DISPLAY CONFIG. 3) CLOCK/CALENDAR CONFIG. Each function is accessed by entering the number of the menu option. F10 terminates the configuration program and writes any changes to the configuration file. CNFG - 1 QSYS CONFIGURATION - USER CONTROL MENU This selection provides access to all system user options. The functions provided vary with the user's security level. Following is an explanation of each function. 1) ADD NEW USERS All users may sponsor new users to the system. The system will prompt for the new users name and password. A default security clearance of 9 will be assigned. The sponsoring user will remain signed on. 2) DELETE USERS Selection of this option will cause the cursor to move to left of the current users name. A prompt will instruct the user to enter a ` D ' to delete the user. The up and down arrows are active to primary users, allowing repositioning of the cursor to the left of another user's name. Any other keys will cancel this option. Only a primary user (security level 0), may delete another user. Any user may delete himself, unless that user is the only primary user on the system. In the event that a user deletes himself from the system, an immediate sign-off will occur, and any messages on file for the deleted user will automatically be purged from the message file during the next file reorganization procedure. 3) CHANGE USER NAME A user may change the name which the QSYS system uses for identification. Care should be taken in doing so, since concurrent changes are not automatically made in the message file. If it is necessary to change the name of a user, known to have messages on file, it is advised that the user FIRST add himself as a new user, and reassign his messages to the new user. Failure to do so could cause the user's messages to become inaccessible. All references in the message file to users not currently in the QSYS user list are deleted during file reorganization. 4) CHANGE PASSWORD A user may change his password at any time. In the interest of security, the password entry will not display. New passwords are effective immediately. The password must consist of 5 data keys. No function or cursor control keys are allowed. The default shift state is CAPS LOCK, but may be overridden. Shift of the characters in a password entry is significant. For example, a password of 'IBMPC ' is considered to be different from 'ibmpc '. CNFG - 2 QSYS CONFIGURATION 5) CHANGE SECURITY CLEARANCE Selection of this option will move the cursor to the current user's security clearance field. The up and down arrows are active to primary users (security level 0), allowing repositioning of the cursor to another user's security field for alteration. A user may not use this option to upgrade his own clearance. In addition, the only primary user's clearance may not be altered. The system must retain at least one primary user at all times. - Function Keys F9 Menu Pressing F9 on the command line re-displays the Configuration Menu. The operation of F9 differs from that of F10 only if the a function was originally accessed directly, without the aid of the Configuration Menu. F10 End The F10 key terminates the current function. If the original access to the configuration program was through the Configuration Menu, then the menu is re-displayed. Otherwise, any changes are written to the configuration file, and QCNFG is terminated. CNFG - 3 QSYS CONFIGURATION - KEYBOARD/DISPLAY CONFIGURATION This selection, available only to primary users, allows alteration of the parameters that control the display colors, cursor size, and keyboard timer. Changes made here affect only the QSYS programs. The DOS screen and all other programs loaded from the JOBQ are unaffected. 1) DISPLAY PARAMETERS The display parameters allow the QSYS display colors to be altered to suite the taste and monitor type of the user. During installation, the display was configured for a black background and border, with a white foreground and bright white highlights. The attributes conform to the colors as described in the BASIC reference manual under the 'COLOR ' statement. Since all changes are effective as they are entered, it is possible, under some circumstances, that data will not display as it is keyed. After all display parameter fields have been entered, the screen will be adjusted to the new values. This makes it possible to test different combinations of colors before making permanent changes. It is generally a good idea to make the foreground, highlight, and background attributes differ, since non-display of data is possible by setting the foreground and background to the same attribute. - Foreground Attribute A value between 0 and 31. This is the attribute used to display data on the QSYS screens. - Highlight Attribute A value between 0 and 31. This attribute is used to highlight input fields and certain other areas of the QSYS screens. Certain QSYS functions, such as the MSGQ screen, require that this color differ from the foreground attribute in order to provide maximum function. - Background Attribute A value between 0 and 15. Even though only values of 0 to 7 will actually display as the background color, values of 8 to 15 will cause changes in other areas of the screen. - Border Attribute A value between 0 and 15. Setting of this parameter will cause the overscan area of the screen to change color. CNFG - 4 QSYS CONFIGURATION 2) KEYBOARD PARAMETERS - Numeric Lock This parameter allows setting the default state of the numeric keypad shift. In the 'ON ' state, the numeric values of each key are used. The cursor controls may be activated by hold- ing down either shift key while the desired numeric keypad key is pressed. In the 'OFF ' state, the cursor controls are active, and the numeric keys can be activated by pressing pressing either shift key. In either state, the default may be overridden for the duration of the current field by pressing 'Num Lock '. - Cursor Size A value between 0 and 7. This is actually the value used to set the top scan line of the cursor. A value of 0 produces a full height cursor, where a value of 7 produces the smallest possible cursor. For example, DOS uses a value of 6. - Keyboard Timer A value between 0 and 59 minutes. The default setting of 0 disables the keyboard timer. Setting the value above 0 enables the keyboard timer. When enabled, inactivity at the keyboard for the specified number of minutes causes the current user to be signed- off, the current function to be terminated, and CLOCK/CALENDAR is displayed. The keyboard timer is only active in the QSYS system programs, and will not terminate other programs loaded through the JOBQ. - Function Keys F9 Menu Pressing F9 on the command line re-displays the Configuration Menu. The operation of F9 differs from that of F10 only if the a function was originally accessed directly, without the aid of the Configuration Menu. F10 End The F10 key terminates the current function. If the original access to the configuration program was through the Configuration Menu, then the menu is re-displayed. Otherwise, any changes are written to the configuration file, and QCNFG is terminated. CNFG - 5 QSYS CONFIGURATION - CLOCK/CALENDAR CONFIGURATION This selection, available only to primary users, is used to configure the CLOCK/CALENDAR screen. 1) SET TIME Used to set the system time. The time is always entered in 24 hour format, even though the clock may be configured to display 12 hour format. The time will always be displayed using the format 'HH:MM:SS ', but may be entered using any standard DOS format. 2) SET DATE Used to set the system date. The date will always display in in the format ' MM-DD-YYYY ', but may be entered in any standard DOS format. If the system date is changed, a MSGQ update will be performed at the next sign-off. 3) DISPLAY OPTIONS - Foreground Character The ASCII value of the character used to form the characters of the system clock. May be a value between 0 and 255. The default is 4. The BASIC reference manual contains a complete list of the ASCII character set. - Foreground Attribute The color of the system clock characters. May be a value between 0 and 31. The default is 15. - Background Character The ASCII value of the character used to make up the back- ground of the CLOCK/CALENDAR screen. May be a value between 0 and 255. The default is 0. - Background Attribute The color of the background characters. May be a value between 0 and 31. The default is 0. CNFG - 6 QSYS CONFIGURATION 4) FORMAT OPTIONS - Time Format The values 12 or 24 are valid. The default is 12. In the 12 hour format the time will be displayed as 00:00 to 12:00. In the 24 hour format the time will be displayed as 00:00 to 24:00. - Clock Format Allows the user to configure the system clock to display the time as 'HH:MM:SS ', which is the default, or as 'HH:MM '. 5) SOUND OPTIONS - Hourly Chimes A response of 'Y ' activates the chimes, and a response of 'N ' deactivates them. When activated, and the CLOCK/CALENDAR screen is displayed, the chimes will sound on the hour. - Hourly Tones A response of 'Y ' activates the tones, and a response of 'N ' deactivates them. When activated, and the CLOCK/CALENDAR screen is displayed, the tones will indicate the hour currently displayed immediately following the Hourly Chimes, if also active. - MSGQ Alarm A response of 'Y ' sets the default state of the MSGQ alarm to on. Two loud, high pitched tones will sound each minute while the CLOCK/CALENDAR is displayed and messages are due. A response of 'N ' sets the default state of the MSGQ alarm to off. Either state may be overridden at the CLOCK/CALENDAR screen with the F17 function key. - Function Keys F9 Menu Pressing F9 on the command line re-displays the Configuration Menu. The operation of F9 differs from that of F10 only if the a function was originally accessed directly, without the aid of the Configuration Menu. F10 End The F10 key terminates the current function. If the original access to the configuration program was through the Configuration Menu, then the menu is re-displayed. Otherwise, any changes are written to the configuration file, and QCNFG is terminated. CNFG - 7 SYSTEM MESSAGES All QSYS system programs incorporate a comprehensive set of error trapping and recovery routines. The System Messages returned by these routines can be classified into three distinct groups. The group classification of a particular message can be distinguished by the accompanying tone(s) and the duration of display. INFORMATIONAL MESSAGES System Messages of this group are not posted as the result of an error condition, but simply to convey the status of the current function. They are characterized by the accompanying short duration tone of medium pitch, unless the message is meant as a warning, in which case the duration will be longer and the pitch higher to draw your attention to the message line. This type of message will be displayed for approximately 3 seconds. Recovery action is not necessary. PROCEDURAL ERRORS System Messages of this group are posted as the result of an incorrect operator action, such as an invalid data field entry. They are characterized by a long duration, low-pitched tone and are displayed for approximately 6 seconds. Recovery is usually automatic. SYSTEM ERRORS System Messages of this group are posted as the result of a critical error condition, such as a hardware or program failure. They are characterized by the typical DOS ' beep ', sometimes accompanied by a long low-pitched tone. These errors require an operator response, and the available recovery options are listed on the prompt line. If the active screen at the time a message is posted happens to be the DOS screen, then the message will display on the next available line and processing will continue immediately. On any other screen, the message will display on line 25 for the specified time and only then will processing continue. In this case, the display of a message may be terminated by pressing the <ENTER> key, unless the message includes options for recovery. ERR - 1 INFORMATIONAL MESSAGES ' task ' Placed in JOBQ The task initiated from a menu or the command line has been successfully added the JOBQ. ' task ' Placed in JOBQ * JOBQ Now Full The last task initiated caused the JOBQ to reach it's operational limit. Any attempt to initiate further tasks will result in a JOBQ overrun. JOBQ Empty The JOBQ is empty. This message will be posted if an attempt is made to display an empty JOBQ, a task is deleted from the JOBQ leaving it empty, or if an attempt is made to release an empty JOBQ for execution. MSGQ Update Required * JOBQ Active The system date has changed and QSYS is attempting to execute the Message File Reorganization procedure, but the system has been signed-off with tasks present in the JOBQ. The JOBQ tasks must be deleted or released for execution before QSYS will automatically initiate the file reorganization. Message Added to MSGQ * MSGQ Now Full The last message added to the MSGQ caused it to reach it's operational limit. Any action which causes QMSG to attempt to add another message to the queue will result in a MSGQ overrun. MSGQ Empty The MSGQ is empty. This message is posted if an attempt is made to display an empty MSGQ, initiate the DISPLAY or PREVIEW functions of QMSG when no messages are due for the active user, or to signal the end of the DISPLAY or PREVIEW functions after the last message due or pending has been displayed. No Messages in File for 'user name ' An attempt was made to initiate the SEARCH/EDIT function of QMSG, and no messages to which the active user is allowed access exist. Message File Empty The message file is empty. This message is posted when any attempt is made to initiate the SEARCH/EDIT function of QMSG and the file contains no messages. ERR - 2 PROCEDURAL ERRORS SYS001 - PARAMETER OUT OF SPECIFIED RANGE The data entered is outside the range of valid parameters specified for this field. Recovery: Enter a value inside the specified range. SYS002 - INVALID RESPONSE A response of other than the indicated valid choices for the current field been entered. Recovery: Retry the entry using a valid response. SYS003 - INVALID TIME The time entered is in an invalid format, or is outside the range of the DOS 24 hour clock. This message might also be posted in QMSG if the time entered on a message input screen is prior to the current system time. Recovery: Consult your DOS reference manual for information concerning the format and range of valid time entries. Also, if entering a time into a message, use the HELP function to obtain the current system time. Retry the entry. SYS004 - INVALID DATE The date entered is in an invalid format, or is outside the range of the DOS Calendar. This message might also be posted in QMSG if the date is prior to the current system date. Recovery: Consult your DOS reference manual for information concerning the format and range of valid date entries. Also, if entering a date into a message, use the HELP function to obtain the current system date. SYS010 - INCORRECT PASSWORD * ACCESS DENIED The password entered does not match the password of any user in the QSYS user list. Recovery: Re-enter the correct password. If you are sure that the password has been entered correctly, then press <Caps Lock> and retry the entry. Consult a primary user if still unsuccessful. SYS011 - ACCESS DENIED TO THIS FUNCTION Your Security Level is insufficient to access this function. Recovery: Consult a Primary User to secure the necessary Security Level for this function. ERR - 3 PROCEDURAL ERRORS SYS012 - USER UNKNOWN TO SYSTEM An attempt was made to send a message to a user that is not currently in the QSYS user list. Recovery: Use the HELP function to check the list of QSYS users and correct the entry. SYS015 - INVALID NAME * BLANK OR DUPLICATE An attempt has been made to log another user into the system using a name that is already in use. QSYS requires that all user names be unique. Recovery: Retry the entry using a name different from those already in use. SYS016 - INVALID PASSWORD * MUST BE 5 DATA KEYS An invalid key was pressed in a user password field while attempting to log a new user into the system. QSYS will not allow the use of cursor control, programmed function, or special purpose keys when entering a password. Recovery: Retry the entry using another password. SYS017 - NO USER ENTRIES AVAILABLE An attempt was made to log a new user into the system, but QSYS already supports the maximum number of users. Recovery: Consult a Primary User. A user must be deleted before a new user can be logged in. SYS018 - CANNOT ALTER PRIMARY USER An attempt was made to delete or downgrade the security level of the only primary user logged into the system. QSYS must retain at least one primary user at all times. Recovery: Assign a second primary user before attempting to alter the first. SYS020 - JOBQ OVERRUN * JOB CANCELLED An attempt was made to initiate a task when the JOBQ was already at it's operational limit. The new task was cancelled. Recovery: Delete a JOBQ entry or release the JOBQ for execution before attempting to initiate additional tasks. ERR - 4 PROCEDURAL ERRORS SYS030 - MSGQ OVERRUN * ENTRY LOST QMSG attempted to add a message to the MSGQ, but it was already at it's operational limit. This error can occur while entering new messages for the current system date, editing existing messages to include the current system date, or if more than 50 messages are in the message file for the current system date during the file reorganization procedure. Recovery: If entering or editing messages, the message file will be updated, but the MSGQ will not. If this error occurred during file reorganization, allow the procedure to complete. After displaying any messages that may be due, the message file reorganization procedure can be executed a second time to pick up any lost messages. SYS031 - INVALID UPDATE FREQUENCY An update frequency was entered that does not comply with the format detailed for this field, or use of the specified update frequency will result in a date which is outside the range of the DOS calendar. Recovery: Refer to 'Message Data Fields ' in the MESSAGES section for the proper format of this field. Make sure that the year of the date resulting from use of this frequency is less than 2100. Retry the entry. SYS040 - CANNOT DELETE ACTIVE MENU An attempt was made to delete a menu that contained active task or menu descriptors. Recovery: All descriptors must first be deleted from the menu before QSYS will allow the menu to be deleted. Refer to 'Deleting Descriptors ' and 'Deleting a Menu ' in the MENU SYSTEM section for more information. SYS050 - INVALID VOLUME LABEL The data entered is not valid for a DOS Volume Label. Recovery: Consult your DOS reference manual under the 'VOL ' command for information concerning volume labels and then retry the entry. ERR - 5 PROCEDURAL ERRORS SYS051 - INVALID DRIVE SPECIFICATION The drive specified in a path or filespec is not known by QSYS to exist, or the specified drive is an emulated drive and only hardware drives may be specified for the current function. Recovery: Correct the path or filespec entry to reflect a drive specification that is valid for the current field. SYS052 - INVALID DIRECTORY PATH The directory path specified in a path or filespec entry is not a valid DOS directory path. It contains illegal path names or is more than 63 characters in length. Recovery: Consult your DOS reference manual for information concerning 'Tree Structured Directories '. Also note that in QSYS, all directory paths must include the entire path from the root directory to the file. Correct the entry. SYS053 - INVALID FILENAME The 'filename.ext ' specified is not a valid DOS filename. Recovery: Consult your DOS reference manual for information concerning 'Files and Filenames ' and retry the entry. SYS054 - INVALID COMMAND An internal DOS or JOBQ command, specified in a filespec entry, is preceded by a drive and/or path specification. Recovery: If the filespec is meant to be an internal DOS command, then re-enter it without the drive and path specifications. If the filespec entry reflects a filename that is the same as one of the internal DOS commands, then QSYS will not support this file. SYS055 - INVALID PARAMETERS An invalid parameter was passed to a program or command from the DOS or QSYS command line. All parameters passed are discarded. Recovery: If this error occurred in QLDR, the <ENTER> option is unavailable, and the associated task, if any, is discarded from the JOBQ. If the task must be executed, then select option 4, DOS Command Processor, to execute the task. ERR - 6 PROCEDURAL ERRORS SYS058 - PATH 'directory path ' NOT FOUND The indicated directory path was not found while searching for a file. Recovery: If this error occurred while attempting to change the active menu, then the change is aborted and the parent menu is reloaded. If a volume label is specified for the menu descriptor, then the integrity of this generation of menus is questionable. If this error occurred while attempting to create a new menu, then the create is aborted. QSYS will only create menus in existing directories. The sub-directory will have to be created using the DOS 'MD ' command from the command line, or the menu descriptor will have to be changed to reflect an existing directory. SYS059 - FILE 'filename ' NOT FOUND The indicated file does not exist in the directory that was searched. Recovery: If this error occurred while attempting to change the active menu, then the change is aborted and the parent menu is reloaded. If a volume label is specified for the menu descriptor, then the integrity of this generation of menus is questionable. This error is normal while attempting to create a new menu. No action need be taken. SYS060 - INSUFFICIENT DISK SPACE This error can occur while attempting to create a menu, or during the message file reorganization procedure. It indicates that the creation of a file cannot be performed because the media to be used doesn't have enough free space. Recovery: If this error occurs while attempting to create a menu, then either the menu descriptor will have to be changed to reflect a drive with sufficient free space, or space on the indicated drive will have to be cleared before the menu can be created. If this error occurs during the file reorganization procedure, it indicates that space, equal to the size of the message file, could not be found on any of the installed drives. The procedure will be aborted. Supply enough free space for the procedure to be run on any drive, and retry the procedure. ERR - 7 SYSTEM ERRORS ASM001 - ENVIRONMENT STRING ' string ' NOT FOUND The indicated environment string was not found in the system environment space. The program is terminated. This error can be caused by improper installation of QSYS, an untrapped error in the IPL sequence, modification of the AUTOEXEC.BAT, or modification of the QSYS system environment strings. Recovery: Re-IPL the system and retry the failing operation. If the error persists it may be necessary to reinstall QSYS. If a program error is suspected, please contact the author with complete information about the error. ASM002 - ERROR ## IN DIR FUNC ## The directory operation identified by 'FUNC ## ' has failed due the indicated error. The program is terminated. The causes of this error can be the same as for ASM001. The following list of errors can be used to help determine the cause of the error. 02 - file not found 26 - seek error 03 - path not found 27 - unknown media type 08 - insufficient memory 28 - sector not found 10 - invalid environment 29 - printer out of paper 15 - invalid drive 30 - write fault 20 - write protected 31 - read fault 22 - drive not ready 32 - general hardware failure 24 - data CRC error The function being performed at the time of the error can be referenced in the following table. 57 - Make Directory 58 - Remove Directory 59 - Change Directory 47 - Get Current Directory Recovery: If the indicated error condition points to a hardware failure, then correct the cause and retry the failing operation. Otherwise, the recovery action is the same as for ASM001. ASM003 - ERROR ## IN FIND PROC An error occurred while attempting to search a directory. The program is terminated. The causes of this error are the same as ASM001. Use the error descriptions listed under ASM002 to aid in determining the cause of the error. Recovery: Same as for ASM002. ERR - 8 SYSTEM ERRORS BAS001 - ERROR ### IN LINE ##### The indicated error has occurred. This is a 'catch all ' for unexpected type errors. The program is halted awaiting an operator response. Recovery: Consult your BASIC reference manual under ' Error Codes ' for a description of the error condition. If a hardware error is indicated, then correct the cause and select the 'Retry ' option from the choices given on the screen. If the error condition persists, then it may be necessary to take the 'Abort ' option and follow the recovery procedure for ASM001. The 'Ignore ' option is seldom desirable, and should only be taken if you KNOW WHAT YOU'RE DOING! INS001 - HARDWARE CONFIGURATION ERROR The installation configuration program has determined that the installed system equipment does not meet the requirements necessary for the installation of QSYS. This error can also be caused by incorrect setting of the system hardware switches, or by the absence of both MEMBRAIN and a fixed disk. Recovery: Refer to 'System Requirements ' in the PREFACE of this document for information on the minimum configuration which QSYS will support. If your equipment configuration meets this criteria, it is possible that the memory size switches are set incorrectly. If the cause is the absence of MEMBRAIN.SYS from the installation diskette, then use MEMBRAIN.EXE and the information supplied in APPENDIX A to recreate this device with the parameters '20,128,1,16 ', and then restart the installation from step 1. INS002 - TOO MANY CONFIG.SYS ENTRIES The Installation Configuration program found more than 20 entries in either the 'UCONFIG.SYS ' or 'CONFIG.SYS ' file. The only option available is to abort the program. Recovery: If a 'UCONFIG.SYS ' file is being used, then recreate it with 20 or fewer entries. If no 'UCONFIG.SYS ' file is being used, then the configuration program will correct the error in the 'CONFIG.SYS ' file during termination. Restart the installation from step 1. ERR - 9 SYSTEM ERRORS INS003 - #####K INSUFFICIENT MEMORY The Installation Configuration program has determined that, due to the QSYS file locations, or to the cumulative sizes of the emulated drives on the system, the indicated amount of memory must be recovered in order to execute QSYS. Recovery: If the size of MEMBRAIN can be reduced by eliminating the number of emulated QSYS files, then take the 'Retry ' option. Otherwise, the installation will have to be aborted. If emulated drives, other than MEMBRAIN, are being used, it may be possible to install QSYS without them. INS004 - TOO MANY SUB-DIRECTORIES SPECIFIED The QSYS file locations, as you have specified them in the installation configuration program, contain more than the maximum 20 sub-directory names that the program can handle. Recovery: Take the 'Retry ' option and respecify the QSYS file locations using fewer sub-directories. INS005 - #####K INSUFFICIENT FREE SPACE ON DRIVE d: The specified drive does not contain enough free space for all of the QSYS files that are to be located there, as specified in the installation configuration program. This error can also occur if the specified drive has been chosen as the drive for creating the QSYS working diskettes and it's size is insufficient to hold all of the files to be located on one of the other drives. Recovery: Ta nteer ZAted distSlunp!ONlunlunse,ONSA issnteer Derives * A ...........................................vid≤ conslunlunSSSS Qwortart they wlunlunlunlunlunlunlunlunlunlunlunlunlunluns onthey w.SYS rentSlunaistem.) ,lunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnASlunlunlunlunlunMSG - ~...........................................GatQSYS me (SlunlunlunLe1 Deslunluns on Delunem w...........................................lunlunlunlund dr MES wSSS QimuONVthey wo ietteSlunIN DdsSlunwn ONlunlun - skSlunlunve sup consut wim Slunlunnn* ENSSSSSYte ion ieldZAlunlunlunlunlunlunlunlunlunoulSlunCLKONcuti De tssup...........................................lun soSlunlun YYYsup,st t 3SlunlunluninaAlun l·inst1 DeB·1 Desy C QSYS.· to, DesONlunlunlunlunlunlunlunlunlunlunlunlunlunlunluncom necatlunlunlunlunnceONr cSuCO. YLOS............................................EXE efr Me...........................................ghe dr Me conslunlunlunlunlunlun - 1 they w 0 cor MeAto sed tLOSinstlun QSlunlunileSlunlun QILOSou glunlungr,MBRONlunlunlun - 1 HSuluneedENUatagesfor tH Detion SedENUSulund mENU Defor aONr co...........................................7 utp109 cons.....................................AmethSlunto sest a109they wMenu.............................................config109AsoftON@instTa╝H1 Des- 8ON@ to,:.EXE ou gre toONlunlun.....................................ation. HHHHSYlunlunlunZA -ON}rv FunctONlunlunlun - 1 SSu pedurS Deted INST - plunlunlun}Pg aDàXElunDOS tàle-0 cotenàime.╝ES 1 o If If 1 ëlunmme 1 mQsho 1 2 n't oit! 1 for a lunlunlunlunlunlunlunlunPaPREFAlunlunlunlunlunlunlunJn. ëlunlunlunlunlunluns on a selun# n. Plun80 plunlunlun - 1 le-E,.......................................Mn. ime.waD B oeqPREFAlunlunlunlunlunlunlunlunlunluno iPREFAlunlunlunlunlunlunlunlunlunlunlunlunLe - 2Q PREFAlunlunlunlunlunlunlun supte. Las mPREFAlunlunlunlunlunlunlunlunlunlunONPREFAcutile-3 REFAcutiime. - 3 tion............................................... plunlunwill plunlun....................................... plun PREFAlunlunlunof D) dfor a lun YYYAPrvlun Ins plunlunlunlunlunlunlunlunlun#..................................I plunlunlunriveLation tRT plunkes ceenPQCaf plunlunopl plunlunlun - 1 a selunlun - 1 olunIB plunlunf plunas l7 plunlunsystem plunlunlunlunlun, thePREFAgr2 lunlunlunlunributr, plunlunlungrugikPREFAlunlunFion o a se2 they fo plunlunED on oXESTSer plund thaGon oime.o usknow, plune fof p plunlunlun@ - 2compuPREFAr co2 SSS upp Funcfor a uAR FuncDOS tlunlun@influnqui plundnmandat yrvescriPREFA@ugMSGUser at yLalun} p a seQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQREFAlunlunlunlunlunlunlunlunS lunlunlunime.p!a Mlunlunlunlunlunlunlunp pZA pura MME lylunlun}. Id QHZAQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQin 1 tioluntena Mlunlunlunlunlunlunlunsiinf03lun is infF CENTa MME vidS.D- Dtiolunlunn,tiolunParriS.D7 ourSetion............................................gguaFG- Dtalla─tertiolundd - D& lun=- Dkesete AvtioluneqprogrtiolunlunEMion............................................oilunlunV03lunMIion............................................ enta Mlunlun DitiolunlunAIMenu.vidlunse mtiolunlun enu.03lunacitiolunERR a Mlunlunlun evtiolun ave QSYoihe sa MlunlunINShe QSYkeslunima QSY. I a Mlunluncula MinaS.Dy mea Mlunluncana Mlunlunut a Mlunlunhesa Mlunlun¢Coall vid programsall ju┬all Dellunk all g iwingvidill nos awingtallalunescriwingoie Di,Mtiolunlunmeawingkes.EXE , wing. Ileastenu. tiolun Infa Mlunlunready3. Alyinsa M - 1 lun iolunteeroustiolunup QQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQrrividlunnnn-rri , the ytiolununctiLArrigd thaa Mgr7 lunte fSettallaEA QSSetoi..............................................C meSet& buts................................SetkesS.Sa Mlunlunlunwaretiolunluniontiolunlunto evecutlystem DEecut ee ecoecut03lunlunlunlunF Ca MlunlunlunJtip ametYYY YtipDel intipgVolunPREF tip7 anda MlunlunlunME tiooiEMEXtiolunwill 5 tiokeshouVtio. Ibod wtioQQQQQQQQQQ n olunlunlunlun}Hep!t to APP -BRse,n olunlunlunlun} Drivestyllunlunyou Fllunluncorpäonalun┤llunlunlunlunlunST FunllunlunQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQert plunlunlunlun.SYS n olunlunlunYYY ter inelunlunlunlunlunlunlunlunMSG - InunctionHelunE FunctionBRitoSG - 6llunlect nction DTIressysterogra the dysteequd dr2 llunimun olunluno ith mystely t Qinalunlunwn n olunlun - n olunlunE,┼dd s wiut wiQ dd ineoff 5dd ly tte st- Df mUPllunlect 19 stBRme thAPP - B1llunCLKtwllun INST - 1rograDeln oinaequy me2) INST - 1onast t 7INST - 1iskeLONTSINST - 1ortMend tSG ad lun SG t py CuSllun Des.SllunTIOallSG ineMENU - 4 sigSG ly t 56covve h- Dluncomve hHeINTrelve hBRncen or cd bCOn olunlunlunlunlunlunlunlunlunlunlunlunlunlun- 8n olunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunluninaluny nocarn Klunlunlunlunlunlunlun........................................ AvBRtion S llunid,donllunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunser progrMlunlun@s wilunal Cllun.....................................n o@ly trogramd tol- D - alHe Functn olunlunescriMENU - 9llunlunr col Dlun Soremlunlunlun}LEg aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaÿButer┴ERR 0 coitho┴up╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝╝ation s Ifeqremluneciisti orQcos fon't oske 1of pAUremlun) PremlunlunlunME r!e APP - CbleKePa╚blescriplun: bleultLOUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUunlunoign-agLEION toagÿion. eepagERR ding YS magupwaaa riation slunEMriotif,tes oriorentnfluny notion.......................................... ri1OWe onrizin mumremlunng ssssssssssssssssssssssssssssssssssssssssrittr!with nfluny no Ue-arittscripst oY rittults mdefremlun& er LEERR ge h ÿing a A ERR 3 en up - 3 naation sculmenrogotiipt.SYrogoryou ddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddunluncannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnr.........................................CNned Diskremlun NeIMTERion............................................fer8 TERr!lunlunriveKe#encedTERscripnd IriveTERultlun u a Mkessssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss cLEQC Sremlunlunlunr cERR nd tor uuplor disMENU - 9 ation s#Ition.............................................................................ENU - 9 otivalfaremlunlund MENU - 9 fogrammmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmunlunlunlunlunlunfileslunlunlunlunlunlunlun}SSS YYYdens I m th Udense te DiDeleinchlunen,orddensablut C oinchlunleasttersinchlunns......................................................s.............................Menu.readye Qs............................. SY Infionainchluninss yos............................. Rteerrp - 1 aup QVCONT 403 GinchlunDOS rp 1 Rlun pMose t..............................................Crp 1 worlunlun 1ablS.Srp 1SPOCch fs of unclunionangeMenu.lunlunr co SYlun%Mangeve tee ge oinchlunend rpr coaramQSYu. 4lunJu.n'tametQQQQinchlun d cou..........................................CN -u. Li andyou (inchlunC)s minche tEMewinch worwill rplunlunhou ContinchSPbodrplunlunlunlun} QSYted in ttalllun - Alunlununc tAda U t or irives Fportu,Jlunyou Fporturitydof Qportu syslun┤portu A r- 3portu QSYlun Sofileslunlunlunlunlunlunluns on or ilunlunME Keyes Q ME rlunwan - Alunlun Soonv QSYlect Q s ontallQSYS 'ts formitoure s fAdalun╢ - AlunlunlunV,JlunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnAelerityd dr Q V sysimu Q }ONlunlunlun SoONLe- 2 - ca - Alund PdinKeyut wile dinroff Q Len,te APP - Alunnd iormlunlun}sid - Alunyou ddddddd...............................................,JDelev...............................................ritylunlunlunlunst t Q ina ALO Q lunlunMe Q riveat tut ndllunlunriver p DesxecheKeyTIOette Dherlunrarhen, 56ORGerru QSYDes Q lunlunINT Q lunlunnceCLK - Alunlunge. CrityyyyyS Q lunlunlunlunlunlun Q lunlunON}lun SoONgrKeylunlunlunlunMBR Q grn,ull Q lunlunlun SoMSG - 8 Aagesuirs of ormlunences of Adacompus,s of or ifor axiAT QSYlunnd it - Alun.....................................Arr ano- 2to se Q lunlunlun C - Alunsoft Q }fileslun- 8u d - Alunlun SoON@rlunura Crogramn s - Alun -k C - Alun Funct Q }ONlunlun patio - A or iME Q lunlunlun Solun........................................M Cm tB/G C MEM0 co UslunfilesFI MEMlunT CQ'td u to mn't oe..............................................UslunONME Qlun SofileslunLOU LUslunoi- 19l cAPP - CIONy nos onm tion. ble-dUslunlunlun}distitor f,y nolunlunlunlunV to mtion....................................................................................................................heFIo selunlunlunlunluncumeUslunONlunlunQ y nolunlunCLKS Uslunst o - A1send MEMlunnte, oreere& 'MsoAPP - CERR y nolunluning aÖUslunONcutio sulunluninaconjculyou dUslunONriveeereyou displUslunlunof D, oro sened -s CfileslunlunptUslunlunod$50Qnd Iy nogreytion tSSSfulERkesy nor cAPP - CQCnd Lfulm tlunlunr c - 1 LluntriUslunlory no - 1 conjlunlunlunlunvalile Uslunn cult to mgramthault o seHos vult o sues.................................prote Commmy y nolunlunribut╒UslunMBRto k EF(CNFn K}MSG - 8APP - Chas a stmenu m twr STUslund thay no}las alunluntups alunlunlunina - ONSIDouTSlunlunlunlunlun Sog a SofileslunONlunlunlunlunLe.CNlunS, syThelun So - 1 declunevalu A Fe syst Dributte syst(Cors..............................................................................................................ed systGUAikfri syste olun l- IANlundiske- I╚hasARC- I prlunating- In't d tha wit- I5o usbydinglune fHoous&MOpeARAousJOBQ - 2compu is pr coe alun%Mouson'tlunlunr coJ -cooth Alunquioth Ddnhanoth(CALL SedinglunMSG Sdinglunage i is plunANluns onding╚luncutidinglun to udinglun2 ! ding5lunlun, stem.ds,es....................................................................k wFAC If td tlunlunamssssssssssssssssssssssssssssssssssss, olun buuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuKeybd Qead}YYY tinYd tlunten ITlunuse Q IsketwleThis IGUBAStions.d tlunENTSuiniNFG S.Dd biniing lunn,iniill T M, andd tlunlunlunlunlunlunluns onstem.─eadlunlunlunigurad tlunlunluns on, olunlunlunlunlune ropYYY lunf yet rriìead}otead}ds,1 Deslun SoON}ONlunlunST(2) FuncrriatimpuFuncTstemIN.FuncsketlunGeFuncGUend MFuncS.ramse d tlunF Cy sm aing ametting d tlunlunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnIm aG Volunmatm aEF andeadlunstem.C)Fid tk wEMead}lunrived t, ohoueadlunlunlun Solun SoONlunlunON}lunyou F ecurd Tlunlun rette havST .......................... QSbe be Tlunlunble T}lunlun}stem.EF lunONlunlunlune s tiii-lunlunVon anlunlunlunlunlunlunVt o Tlunlunume, Ddisthavlun SoIN Dtions mebe lunge, meon anlun So al melowte enu.EF lunlunns.t sss-lect Tlunlunlunoult snalCLK Ret sthey lun Soduct olun So ettes .Bst t Tina! LO-QetteshavMeN.s................................be lun s................................on any C, Is................................Funct Des¼s................................turnlunSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS................................σMENU - 4ng s................................low 56C DescrSetluncomDescrrr-INTisplaDescr nceumEF lunCOgiDescrthey .EXE expeDet ogR DeecurlunIBDe .B▀knDe! T - 1 havto sNU vbe card tha von anr, it dEF lunldon' vturn monat vσlunt ha vlowullow ├Setnotiq├├├-ages T 1 tion Sed p├nalid,,,,Q├they for an tiEF lun7 re Daecur.....................................Ait taDa .Bto senclDa! Menu............................................. Tr cohavsoftpis. Nbe Tao usEF lun- 8ds s. NFunct:4s. Nturnre to fiEF lun.....................................scs. Nlowrogram TlunSet - to oEF - FunctescEF escritecEF nallunr coEF they ME , Den nluntallaompSYS, g aipSYS, I'BICE}LE 0 co cSYS, lunSYSTemgo Ife femt teciICESile pQer toemed copn't oe......................................Aeme in of puratioen nlun) ime.aiecutterupaioree ICEME parPa5ai Ed QS ai.SYSLOUICEs onthey foi+Pleaseee ION in leaseI'ion. DRen nlunding unlease wa a mgoeqOpeen nlunf,csa mile plun a med coption...................................................................................................................a me in OW a m: luncumeKecutng s%CKorelun DeKpar U PK Edst oA1 K.SYSs mICEcutithey f& ..............................olunteee ERR ABolunteI'ing aICEcutiLE 3 essolunte - 3 y O DEgoculcompuen nluniptry DEile pyou d Messa DEed copcanICEinae in ned nec DE: Neen iQSYS inecutferICEriveoreUserporatQSYS inpar#unctQSYS in Ednd IICEluny no Q r. they fkesabsr. QCXen nlunlunlunr cLE lunlunr c lunlunlunlunlunlun}ON}n the: es.................................for een nlunn ct,oreributvolt,parors......................................................................................It, EdikICE}lun So Qina 1I'lun SoMSG - 8 o usfileke golunboden nlunSSS .............................ke e in u..................................en nlun -am en nlunh ftion dorednfile tion dparlun tion d EdMSGs MEen nlunage iICE}BAT en n lunlunen nlunds,e-lunlunFACit²Edpurur²ou d⌡⌡⌡⌡P² SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS Qe-}wantinteeo dtiptenhor I'luneth do dRT wlesyso dºlun is o dknoENT DeguaUIS.D DguaLDaree-ME - 2T M▓ I'lunini.SYS I'lunLOUe-s onntarlun - I'lunlunigura I'lunour, y I'lunlunem ram t SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSStthe I'lunlunf y I'lunlunlunlunlunlunlunVRT entvedon EºlunlunlunlunlunporsUIlunlunLeLD Kion..................................s - 2with w I'luner(e-cutintarote-lunlun& e-cutirohe se-cutiEdlunluncutiou dit fponon SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSunlunlunlunluntupOStiplun.......................................²st t -fileslun SohesA1OSkno¢ . I'lunlunlunriveLDjunctnie - 2Compe-lunlunlun SofileslunON}lunlun}en,e-lunlunut e-r c SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSunlunlunlunmu I'lunON}n theºteerεORknoup Qto I'lunlunlunlunlunlun Solun Soevalur to DOS lum QL d0e-}fileslun..............................................Ce-lunlunCNFG - 6 surwanluniliry mUIlunJry mLDamete-@RT lunlunlunlunVolunutry m dlunlunlunntarC)age i I'MENU - 8EMe-lunlunwill ENN I'ou dhou I' SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSun Soa MwanlunuraYYY Ymadted lunlunlun Part to a Mlunse,lunlunlunlunat pYYY Y...................................lunlunlunlunvidyou Fdyensdlunlunlunworlunlunlunter SEdying sST psLOU beQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ Mlune inaluny no.SYS tega Mlunes YYY LOUoflunluns onS B,4ly FtioMSG - e sa MlunlunE Fa Mlunlunlunlunlunlunluns on...................................lunem a Mlunìlunlunlunlun(CNa MlunlunlunlunlunlunlunVing sIN Das wa Mlunwn ge,EXtar - lunLe lunlunlunlunMelunlunlunoffff* a Mlunlunlunlunlunlunlunlunlunlect lunlunlunlunlunlunlunlunlunlunlunlunlunlunlunlunolua Mlunhes soJOBQ - 2 QSYSst t.IJOBQ - 2 diLOlunlunlun Ne QV di1 Delunlunluny C╖5 Deslunrive't uTIOSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS ofill nolunrivee FlunMENU - 8 Seqtioe Dilunr cS BINTnd dSeqklunlunlunlunCOlunr c....................................EXE O evINST - 11Sge.a MlunlunIB ev QSYSlun you ev di lun - 1 ing sto slunlunlunl2 a Mlunr, ilunlunlunlunlungr't ulunenceVofMBRt haVe FEAlun 1tarlunlunlunlunages.............................................................................Mmadtion S6 a Mlunlunlun 1...................................consONr coINST - 11lunLeⁿenslunNa MlunlunlunlunlunMenu............................................. Cⁿing ssoftms w Tas on wtarlunser w :up wk Qina@of.....................................lun@e FrogramSa Mtio -Va MlunluninaYYY Y#Mescri - 1 a Mk pr coa M...................................ME Socomp malunnnnnnnnnnnnnnnnnnnnnnnnnnnncomplay criptnd icomp LTION comp QSlunfrowhelunlunSYST 4≥lunC)whelunC.ec 4 - 2 use ......................................... 4winisC.Bwhelunluniv 4AG...........................................G oAPP -lunzwheluns fconjM RlunlunME #Mlun: whelunlun,4whelunt pillwhelunlunlunlunlunlectiren QSlunluns onlaylunlunlunlun QinaVs.................................lunlunlunlunlun ncwinT T offncibut ONVAG76e riptoAPP -JOBQ Ex Syriptot wlun DeriptoM RF ⌠ripto#Mto refor mwhelunWONlunlunlun soe......................................lay he peverwhelunlun oe...................................... QSlunluncutide.*Pe,t to ≥ - 1 Ninas.................................you.Keyswhelunlunopewhelunation,s.........................................Cwhelunlun YYYt 
